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INTRODUCTION 

This manual is a guide which will assist Burroughs personnel in identifying and resolving certain prob- 
lems with the B 900/ CP 9500 system. It gives both a system overview and a detailed discussion of 
the contents of a system memory dump, probably the single most effective tool available for the task 
of analyzing problems. 

This manual is divided into 12 sections and 6 appendices, A through E. 

Section 1 provides an overview of the methods by which a system dump file can be created. 

Section 2 explains the operation of the SYSANALYZER program which is used to convert the numbers 
and symbols from a hexadecimal memory dump into a format that is more easily read. 

Sections 3, 4, and 5 give an overview of system operation. Section 3 is a software overview, section 
4 discusses interprocessor communication, and section 5 discusses the theory of operation for the sys- 
tem software. 

Sections 6 through 12 discuss the actual memory dump as it appears after it has been converted usine 
SYSANALYZER, ^ 

Section 6 is titled Heading Information. This section discusses the general information contained in 
the first four pages of a memory dump. 

The next six sections of the manual discuss the major divisions of the memory dump. They are dis- 
cussed in this manual in the order in which they appear in the dump. They are: 

Section 7 - Virtual Memory 

Section 8 - Operating System 

Section 9 - Data Communications 






Section 11 - Disk Management 

Section 12 - Buffer Memory 

The appendices supply detailed information which is frequently needed as reference. 

Appendix A Hsts operating system error messages. 

Appendix B gives task processor error messages. 

Appendix C is a list of, and an explanation of, SYSANALYZER error messages. 

Appendix D gives techniques for user task analysis. 

Appendix E is a guide for trouble-shooting system failures. This is to assist a field engineer in making 
initial efforts to correct problems. 

Appendix F is glossary of terms. 

It is assumed that the support personnel using this manual are familiar with CMS concepts and the 
implementation of these concepts on the B900/CP 9500 system. It should be understood that this 
document is not a substitute for a properly trained software support person. 
11M78 
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Related Documents 

The following manuals may be of assistance in understanding system operations: 
CMS Software Operation Guide, form 2015228-001 
CMS Data Communications Reference Manual, form 1090909 
CMS Master Control Program (MCP) Reference Manual, form 2007555-001 
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SECTION 1 
MEMORY DUMPS 



INTRODUCTION 



A system memory dump is a file created on disk containing the contents of the system memory. The 
system memory dump, in conjunction with system log files, are the most essential tools to aid in the 
analysis^ of system failures. It is very important that a memory dump be taken each time an unexplained 
system failure occurs. It is equally important that the dump be taken properly and contain useful infor- 
mation. This section details when a memory dump file creation occurs. Printing of the dump file is 
performed by the SYSANALYZER program, and is covered in Section 2 of this manual. 

CREATION OF DUMP FILES 

System dumps are produced in three distinct ways. They may be created automatically by the operating 
system when the system detects a failure (such as Task Processor/Data Comm Processor Logically Not 
Ready, or a CLEARSTART takes place); the memory dump may be requested by the operator using 
the GT MD intrinsic, explained in Section 9 of the CMS Software Operations Guide (SOG), form 
2015228; and thirdly, the memory dump may be manually created by using the ROM/PRAm' dump 
facihty. This option is to be used when a system hang occurs. (System hang is defined as a condition 
where the system is unable to communicate with the operator.) It is also used when the system fails 
to automatically create a dump. Operation of the ROM/PRAM dump facility is explained in Section 

DUMPS CREATED BY OPERATING SYSTEM 

Dumps produced by the operating system are written into a previously-assigned disk file named 
SYSDMFILEnn. This file is assigned space by the monitor startup procedure of the OS. The decimal 
number nn is determined by startup in the following steps. 

Startup attempts to open, initialize, and close the file SYSDMFILEOO; if a duplicate file condition oc- 
curs on the file close attempt, the file just created is purged and an attempt is made to create 
SYSDMFILEOl. This procedure is repeated until a successful close occurs or no file number is found 
to be available. The maximum number of system dump files allowed on the system disk is six 
(SYSDMFILEOO through SYSDMFILE05). This procedure ensures that previous vahd dump files are 
not destroyed by subsequent warmstarts. If startup is unable to find sufficient disk space, an appropri- 
ate warmng message, "SYSDMFILE NOT CREATED MAX NO EXCEEDED," is displayed on the 
Operator Display Terminal, and the system continues the warmstart. The normal operator action is 
to first reorganize the system disk so that sufficient space is available, and then re-warmstart the system 
to create a valid dump file. The OS monitor dump action can only write into a dump file created at 
the last warmstart by the OS monitor startup action. 

NOTE 

An unused system dump file is removed automatically as part of the system 
disk power-off procedures. If the system is not powered off in an orderly 
manner, or if the system hangs, an empty dump file will remain on disk. 

DUMPS CREATED BY GT MD 

The GT MD intrinsic will dump the system memory to the current dump file while the system continues 
normal operation. This can be useful in gauging system performance, and for certain types of failures 
that do not cause fatal error conditions, such as with programs that do not appear to be executing 
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ROM DUMP FILES 

A system can be dumped to disk by use of the hardware ROM/PRAM dump facility. This ROM dump 
must be reformatted by a utility, 'ROMCONVERT,' to be identical in layout to a dump file created 
by the operating system. In this form it can be analyzed by SYSANALYZER. Operating instructions 
for ROMCONVERT are contained in the CMS SOG. 
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SECTION 2 
SYSANALYZER PROGRAM 



INTRODUCTION 



SYSANALYZER is a program which selects and prints data from a system dump file. It also performs 
some basic dump analysis by highlighting suspected system errors. This section describes how to use 
the bYbANALYZER program, and includes the format of the printed output. 

DUMP FILE REQUIREMENTS 

The SYSANALYZER program requires as input either a system-created dump file or a ROM dum" 
file which has been converted into the format required by SYSANALYZER. This conversion proces^ 
is performed by the ROMCONVERT utility. 

The 3.04 version of SYSANALYZER also requires that the dump file being analyzed must have been 
created on a system executing under 3.04 MCP control. 
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SYSANALYZER SYNTAX 

Parameter values are supplied to SYSANALYZER through a single BOJ initiating message. The syntax 
of this message is depicted in the railroad diagram below. The options may be entered in any order; 
the analysis takes place in the option sequence depicted in the diagram. 



SYSANALYZER- 



■MFID«PACKID>)- 
■FID(<FILE-ID>) — 
-ALL 



■VM- 
■OS- 



•DC- 



•TP 



■DK- 



'BM' 



■HEX- 



-1 • 

■ A- 
•M- 



•DCA- 
■DCP- 
■BUF- 



BUS' 



-J - 

■os- 

•DC- 
■TP- 
■DK- 
-BM- 
-7 — 
-N- 



ED2644 
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CAUTION 
The options ALL and HEX are advised for analysis requested by the user. 
ALL produces a formatted full-system analysis and a hexadecimal dump; 
HEX produces a hexadecimal dump. The user is advised to ignore the more 
specific analysis options, except when otherwise requested. 

The following points should be noted: 

1. If the user enters the "FID( )" option and/or the "MFID( )" with no other options following, 
only the header page and dump file information are output by the analyzer program. 

2. If the initiating message contains no options (consists only of the string SYSANALYZER), the 
system analyzer uses default -values equivalent to "MFID(< system pack>), FID (SYSDMFILOO), 
ALL;" If all options are omitted, the semicolon is not included in the message. 

"?. If the DK option is selected, a He.x dum" of the disk processor will automaticalb' follow the for 
matted version. 



Option 

MF1D( ) 



Meaning 

The <pacliid> specified is the paclc on which dump file resides. 



F1D( ) 



VM 



DC 



TP 

DK 
BM 
VM 
HEX 



BUS(n) 



The < file-id > specified is that of the dump file to be analyzed. 

Perform analysis of: 

Virtual Memory (see VM) 
Operating System (see OS) 
Data Comm Processor (see DC) 
Task Processor (see TP) 
Disk Processor (see DK) 
Buffer Memory (see BM) 

Perform analysis of virtual memory. 

Perform analysis of operating system, if no suboptions are specified, use ail suboptions. 

Suboptions of OS: 

(A) Activity management. 

(M) Memory associated with OS processor. 

Perform an analysis of each data comm processor. If no suboptions are specified, use all suboptions. To 

restrict analysis to individual DCPs, use the "BLIS" option. 

Suboptions of DC: 

(DCA) Include analysis of data-comm-related parts of operating system. 

(DCP) Include analysis of data-comm-related parts of disk processor. 

(BUF) Include analysis of data-comm-related parts of buffer memory. 

Perform an analysis of each task processor. To restrict analysis to individual task processors, use the 
"BUS" option. 

Perform analysis of disk processor. 

Perform analysis of buffer memory 

Perform analysis of virtual memory. 

Print an unformatted hexadecimal dump of the memory or memories specified. If no suboptions are 

specified, print a full hex dump of the system. 

Suboptions for HEX: 

(OS) Print a hex dump of memory associated with the operating system. 

(DC) Print a hex dump of memory associated with the data comm processor. 

(TP) Print a hex dump of memory associated with the task processor(s). 

(DK) Print a hex dump of memory associated with the disk processor. 

(BM) Print a hex dump of buffer memory. 

Each "n" is a hexadecimal character that corresponds to a given physical bus address. When the BUS 
option is specified, only the specified bus addresses are considered to be in the dump file. 
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The BUS(n) option allows analysis of the specific task processor(s) or data comm processor(s) that the 
user wishes to examine. When this option is not used, all task processors are analyzed as a result of 
TP, and all data comm processors are analyzed as a result of DC. 

The OS processor memory must be available if the DC(DCA) or VM option is specified. To do a com- 
plete analysis of a DCP when the BUS (n) options is used, the bus address of the OS processor must 
be specified, as well as the bus address of the given DCP. 

The BUS (n) option may be used together with the ALL option. This causes a comprehensive analysis, 
but only of the bus addresses specified. 



SYSANALYZER EXAMPLE 

The following initiating messages result in the same analysis. The actual sequence of analysis is repre- 
sented by the order of the options in the second message. 

BOJ Message 1: SYSANALYZER FID(THISFIL), MFID(THATPCK), ALL; 
BOJ Message 2: SYSANALYZER MFID(THATPCK), FID(THISFIL), ALL; 



SYSANALYZER CONVENTIONS 

The reader should be aware of the following conventions which apply to the printed output: 

FORMATS OF TITLES 

Titles boxed in asterisks are titles of analysis options, suboptions, and headings of individual data 
structures. 

ERROR MESSAGE FORMAT 

T7rrr*t- m^accorrpc qrA r^rintArl f\r\ tVip pvtrf»mp Ipft hanH nortion nf thp oiitmit lisitiTie. and are preceded 
and trailed by three dollar signs. 

BYTE REVERSAL FORMAT 

Data declared to be two-byte is stored in memory byte-reversed by the BDS processor. In order to 
provide a consistent approach to output, the following rules concerning byte reversal have been fol- 
lowed: 

1. All data read from the dump file is printed in byte-reversed form (as it was found in the dump 
file). 

2. Addresses that are calculated by the analyzer and printed in front of a dump area (in the same 
columns as data titles) are printed in a byte- forward manner. 
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PRINT FORMAT 

The formatted analysis uses a global print routine to produce the printed output. The 120-character- 
wide print hne is logically divided into a 40-character and an 80-character area. The 40-character area 
is used to display titles (and addresses) right-justified preceding the appropriate data. The 80-character 
area is used to print the data. The data is always printed as follows: 

<two bytes > blank <two bytes > blank ... <two bytes >. 

If the number of bytes is odd, the last <two bytes > are printed as < < single byte> blank >. The 
routine will continue on to succeeding lines, as necessary, if more than 32 bytes are to be printed. This 
routine is not used when data is printed in a table format. 



NOTE 
Disk addresses are NOT byte-reversed. 



ROMANALYZER 



A ROM-generated program may be analyzed directly by the program ROMANALYZER at those times 
when it is not possible to run ROMCONVERT. ROMANALYZER is explained in detail in the System 



Operation Guide 
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SECTION 3 
SOFTWARE OVERVIEW 

The system firmware comprises all necessary modules to provide full CMS support. This includes: 

1. Operating system (OS). 

2. Data storage subsystem. 

3. Task processor control routines and language interpreter. 

4. System-dependent initialization routines. 

5. Data communication control, messsage handling and line protocols. 

Figure 3-1 illustrates the interrelationship of the above modules. Initialization routines are not included 
in the figure, as they are a stand-alone function. 
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OPERATING SYSTEM (OS) 

The operating system resides in one processor/memory set. This processor maintains an interface to 
all I/O devices except the data storage subsystem and the data communication lines. The operating 
system is divided into the following modules: 

1. Operator Interface (OI). 

2. Data Access (DA). 

3. Job Management (JM). 

4. Processor Interface (PI). 

5. Monitor (MN). 

6. Activity Management (AM). 

7. Data Comm Activity (DC A). 

OPERATOR INTERFACE (01) 

The operator interface module provides a communications interface between the system and a variety 
of operating processes; an example of such an interface is that between an operator and a user pro- 
gram. Included in the duties of this module are: 

1. Collecting information. 

2. Syntaxing messages. 

3. Formatting messages. 

4. Routing messages. 

5. Providing system information to the operator. 

A HonHiincj all T /O fn the DnRrator Disnlav Terminal (ODT). 

DATA ACCESS (DA) 

The data access module provides the logical/physical interface for I/O devices (line printer, ICMD), 
and the logical interface to the data storage subsystem. Included in the duties of this module are file 
management and buffer memory management. 

JOB MANAGEMENT (JM) 

The job management module provides an orderly system environment for user jobs. It tracks the state 
of each job from beginning to end, and synchronizes the occurrence of multiple commands to the same 
job. 
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PROCESSOR Interface (pi) 

The processor interface module, in conjunction with the corresponding module in other subsystem pro- 
cessors, provides the processor-to-processor communication link. Through the use of memory mail- 
boxes, messages are transferred between processors. 

MONITOR 

The monitor module provides the capability to record, analyze, and report system events. 

ACTIVITY MANAGEMENT (AM) 

The activity management module provides the environment needed for intermodule cooperation. This 

the OS modules to communicate with one another. It could be loosely regarded as the interpreter of 
the remainder of the system. 

DATA COMMUNICATION ACTIVITY (DCA) 

The DCA module comprises four major submodules: 

1. Data Comm Communicate Handler (DCCH). 

2. Data Comm Loader (DCL). 

3. Result function. 

4. End-of-job function. 

The data comm communicate handler (DCCH) provides the logic necessary to perform the functions 
indicated by a data comm communicate. These functions can be issued by an MCS or by a data com- 
munications user program. The primary function of the DCCH is to validate parameters, enforce user- 
defined limits, provide message routing to/from the data communication programs, and control the 
message interface to the DCP. 

The data comm loader primes the necessary control and routing tables to be used by the other DCA 
modules, and loads the DCP microcode and NDL tables. 

The result function provides message handling for messages sent from the DCP. This module routes 
messages and control information to the assigned programs. 

The end-of-job function performs the necessary housekeeping and deallocation of resources when a 
program terminates. 
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DATA STORAGE SUBSYSTEM 

The data storage subsystem resides in a processor/memory pair separate from the operating system. 
It works in conjunction with the operating system (OS) to provide the system with a highly efficient 
mechanism for controUing high speed storage media. Logical as well as physical control routines are 
incorporated into this subsystem. In addition, the data storage subsystem controls the display and 
maintenance routine (DMTR) module. All disk subsystems, other than the industry-compatible mini 
disk (ICMD), are connected to the data storage and maintenance processor (DS&M). 



THE TASK PROCESSOR (TP) 

User programs are executed in a separate processor known as a task processor. This processor is 
managed by the OS processor and requires the OS processor to initiate and control all its I/O requests. 
Jobs are assigned to the task processor by the job management module of the OS processor. The com- 
plete set of necessary firmware is known as the Interpreter Control Program or ICP. This set of firm- 
ware falls into two categories: control/support logic and language interpreters. The control/support 
logic can be further characterized as follows: 

1. Operating system communication (PI). 

2. Local memory management (PM, VM). 

3. Job Control (JC). 

4. Processor Management (PM). 

The MPLII interpreter is required for execution of system utility programs. The COBOL/RPG inter- 
preter is a user option that is specified in the WARMSTART information area of SYSCONFIG. 



DATA COMM PROCESSOR (DCP) 

The DCP firmware is produced by using the NDL compiler and the NPC900 program, and resides 
in the DCP. The DCP is composed of three major modules: 

1. Scheduler. 

2. Host control. 

3. Line manager. 

The internal organization of the DCP is shown in figure 3-2. 
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Figure 3-2. DCP Internal Organization 



SCHEDULER 

The scheduler module assigns processing time to the line manager and host control on a predetermined 
basis. 

HOST CONTROL 

The host control module is responsible for all external interfaces and provides support for: 

1. Request queue processing. 

2. Result queue initiation. 

3. Processor interface. 

REQUEST QUEUE PROCESS 

The request queue process submodule is primarily responsible for routing messages from the DCCH 
portion of the OS data comm activity module to the directed station. Additionally, it initiates station 
and line functions as requested. 
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RESULT QUEUE INITIATION 

The result queue initiation submodule takes complete messages, station functions, or line functions, 
and places them on the data comm activity (DCA) result queue, indicating that a complete message 
has been accumulated from a data comm line or that the requested station or line function has been 
handled. It then signals the DCA via PI.SEND. 

LINE MANAGER 

The line manager module determines if a given data comm line is currently active, and yields control 
to the appropriate NDL process (s-op handler, interrupt scheduler, or interrupt handler) at the appro- 
priate time. If the NDL process module is in control and an interrupt or a pause s-op is detected, 
the line manager module transfers control to the scheduler module. When the expected interrupt occurs, 
the line manager returns control to the NDL process. 

THE NDL PROCESS 

The NDL process is logically partitioned into three sections: s-op handling, interrupt scheduling, and 
interrupt handling. 

The s-op handler performs logical functions and initiates control of the physical data comm line. When 
code being processed by the s-op handler requires or anticipates an external event, control is relin- 
quished to the interrupt scheduler. 

The interrupt scheduler conditions the necessary hardware and logic functions to expect the event. 

The interrupt handler is invoked when the event (interrupt) occurs on the data comm line adapter. The 
interrupt handler performs implicit functions such as parity generation and checking, format validation, 
and translation. The interrupt handler invokes the NDL s-op handler to return the results of the last 
event that occurred. 
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SECTION 4 
INTERPROCESSOR COMMUNICATION (PI) 



This section is intended to describe the mechanisms used in interprocessor communication. The specific 
uses made within each processor are described in section 10 of this document. 

Interprocessor communication utilizes the processor interconnect bus hardware via the interface control 
(not covered in this manual). The interested reader is referred to the B 900/CP 9500 Field Engineering 
Technical Manual Volume 3 (form 1129418). 

The interface between the DS&M and the OS does not use the mechanisms described in this section. 
A special interrupt mechanism exists between the DS&M and the Data Access activity of the OS. 



MAILBOXES 

The task processor and the DCP both have two mailboxes. The "output mailbox" is used for commu- 
nications to the OS processor, and the "input mailbox " is used for communications from the OS pro- 
cessor. 

Each mailbox carries traffic in one direction, but has a standard layout of bytes and their functions: 

Field Bytes Use 



Text 

Request function 
Request processor 
Result processor 
Result function 
System mix number 

Reserved 
Flags 



16 Contains the actual text passed. For a CMS communicate this will be the 

communicate parameter area (CPA). 

1 This is the action id or name that this message was directed to. 

1 This is the bus address that this message was directed to. 

1 This is the bus address that this message originated from. 

1 This is the action id or name that this message originated from. 

1 Where appropriate, this will contain the task id of the job initiating this 

communication. 

1 

1 These flags define the status of the mailbox. 

The values are as follows: 

MSB 7 = Request message 

6 = Unused data comm processor 

5 = Task processor error 

4 = Task processor rejected 

3 = Operating system accepted 

2 = Given to operating system 

1 = Task processor accepted 

LSB = Given to task processor 



The request and result function fields contain an action name or action id dependent on the original 
request. In general, a response to a previous communication is directed to an action id, and an original 
request is directed to an action name. For CMS communicates, this id is @FF@. 

The flags are used to specify current ownership of the mailbox. The OS processor always uses the mail- 
box in the other processors. 



See Section 10 of this manual for further details of mailbox functions. 
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SENDING A MESSAGE 

OS TO TP 

The procedure is as follows: 

OS 1. Check status of input mailbox of desired TP. If not ok then wait. 
OS 2. When ok, insert text. Reset OS accepted. Set given TP. 
OS 3. Interrupt TP. Wait. 

TP 4. If handler not available, mark mailbox as TP rejected, interrupt OS; OS will reset TP re- 
jected, set OS accepted. Wait, then retry. 

TP 5. If handler is available, will set TP accepted, initiate appropriate function, and interrupt 
OS; OS will mark box as OS accepted, and finish the send function. 

TP TO OS 

The flow is almost a reverse of the above: 

TP 1. Set up output mailbox (if owned by TP). 
TP 2. Set given OS, interrupt OS. 
OS 3. Copy message in, set given TP, interrupt TP. 
TP 4. Set TP accepted, inform caller. 

OS TO DCP 

OS 1. If OS doesn't own mailbox, wait. 

OS 2. Copy message into mailbox. 

OS 3. Set given TP, request message, reset other flags. 

OS 4. Interrupt DCP. 

DCP 5. Set given OS, reset request message, interrupt OS. 

OS 6. Set OS accepted. 

DCP TO OS 

DCP 1. If output mailbox is not owned by the DCP, look for something else to do. 
DCP 2. Else, set up mailbox, clear flags. 
DCP 3. Set given OS, interrupt OS, forget it. 

OS 4. Copy in, set given TP. Continue. 
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TRANSFERRING DATA 

Data transfer is not a PI function; however, interprocessor communication is usually needed before 
such a transfer can take place. 

Data is transferred via the bus under the control of the OS processor. During transfers from disk to 
any memory, the requesting processor is responsible for freezing the appropriate memory area, and 
is expected to leave it alone until informed otherwise by the OS processor. This mechanism is transpar- 
ent for data file I/O as buffer memory is an OS-managed entity, but is not transparent for code or 
data segment I/O. 

Note that any processor may attempt a remote access. Each processor is required to adhere to the re- 
strictions imposed by the OS processor. 
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SECTION 5 
SYSTEM SOFTWARE THEORY OF OPERATION 

OS OVERVIEW 

The OS may be considered to operate using three levels: 
Activities 
Actions 
The kernel (nucleus) 

APTIV/ITIFS 

Activities are groups of actions and are committed to specific functions, specifically: 
OI -Operator Interface 
JM -Job Management 
DA -Data Access 
DC -Data Comm 
MN -Monitor 
AM -Activity Management 

MV^ I lUINIO 

An action is a region of code which may be given control of the OS processor. In practice, an action 
is a procedure that is executed by the Activity Management procedure "INVOKE." The different types 
of actions are defined as follows: 

AVAILABLE ACTION: A region of code that is called upon to perform some specific functions. 

EXECUTING ACTION: An instance where it was decided to use a specific available action. 

CRITICAL ACTION: An action that cannot be invoked if it is already executing. 

CONTINUOUS ACTION: An action that never yields the processor voluntarily. 

KERNEL 

The kernel, or nucleus, is a microcoded area that contains commonly used routines. Some of these 
routines have responsibility for interactivity communication. With the exception of the monitor activity, 
no activity may directly contact another, it must call a specific nucleus routine to perform the switch. 
(See figure 5-1.) 
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Figure 5-1. OS Overview 
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The nucleus is considered part of the AM (Activity Management) activity, and is permanently resident 
along with the other activity management functions: AM actions, real time clock (RTC), virtual mem- 
ory (VM), and processor interface (PI) at the low end of page 0. 

Routines within it maintain tables, lists, and queues on behalf of AM, and also control the invocation, 
scheduling, and deallocation of actions. These routines will apply available memory for use by actions, 
invoking if necessary the more complex VM routines to make the space. 

11 ilica Miwwii as a Maiua uiuCK IS Crtaitu lui tvtij' a^-liuii. i Ot aiz.t ui a SLaius uiut-ft. i:> ai^\.ciiic 

to a given action, avs snown m iigure 5-2, eacn status block is diviueu mto turee lOgicai sections; comm 
area, control area, and stackframe. Of these, only the size of the stackframe may vary from action 
to action. The status block, as its name imphes, is used to hold the status of the action when it be- 
comes suspended, as well as the communication parameters it receives or wishes to send to another 
action or micro routine. 
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Figure 5-2. Status Block Layout 



One to four workblocks may be associated with an action. They are accessible only to the action and 
activity management, and are used to hold the data pertinent to the action. It is possible for a work- 
block to hold data which may be used to supplement comm area data when one action calls another. 

A link block is a work block which an action or AM has deemed necessary to be in scope to the whole 
of an activity. Before an action may manipulate the contents of a link block, its status must be re- 
turned to that of a work block. 

VM 

VM is responsible for making space if required, maintaining descriptors and Unks for these, and return- 
ing space. 
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PROCESSOR INTERFACE (PI) 

PI controls interprocessor communication. It scans two arrays, one for input, one for output. On de- 
tection of a processor's readiness to send or receive a communication, it will: 

1. Read that processor's output mailbox. 

2. Write to that processor's input mailbox if a message is available. 

Message transfers in either direction are monitored by a system of acknowledgements. 
AM_J^CTION_UST POINTERS 

In order to keep track of the location of the status blocks, a list of pointers to them is kept resident 
in memory. The maintenance of this list is the responsibility of routines within the nucleus. The Hst 
consists of 100 two-byte entries @00@-@64@. Each entry is the absolute memory address of its associ- 
ated status block. The first fifteen entries are for resident actions (one continuous, and fourteen 
critical). Refer to figure 5-3. 
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Figure 5-3. Action.List Pointers 
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The continuous action may, in fact, be any of four which are designated "continuous." Only one may 
run at a time, so they share a status block. This status block is permanently located in a fixed location 
within AM resident area. The continuous action will always run to completion without yielding the 
processor to another action. Entries @01@ thru @0D@ are for the "critical" actions; @0E@ is a 
critical action reserved for future use. These are actions of which only one invocation may exist at 
any time. These actions may yield the processor. 

Entries @0F@ thru @64@ are assigned on an as-required basis. They will always be in overlayable 
memory. However, all status blocks with their associated work and link blocks, will always be located 
on page 0. 



STATUS BLOCK LINKING 

OS operation consists of the serial running of actions, with interspersed nucleus code. Within the nu- 
cleus is "scheduler" code, which determines the order in which actions are given control. Scheduler 
scans through the status blocks to find one which indicates by its status byte that the associated action 
is ready to run. 

All current actions will be linked together in a circular list, only critical actions which are active will 
be included. The hnking mechanism is the "LINKl" byte, containing the "entry number" of the next 
action on the list. (Refer to figure 5-4.) 
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Figure 5-4. Status Block Linking 
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Figure 5-5. Normal and Suspension Queue Links 



It may be that an action wishes to invoke a critical action which is ahcady lumiing, or wait fur some 
system event to occur. In these cases, a queueing mechanism is used, and the entry number or the 
next action in the queue will be in the status block "LINK2" byte. There are a large number of possi- 
ble queues, as can be seen from a look at the dump. The above description is only intended to describe 
the linking mechanism for each queue, as shown in figures 5-5 and 5-6. 

The entry number, then, is used as an index into the AM. ACTION. LIST pointer table which contains 
the absolute memory locations of the status blocks of current actions. 
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Figure 5-6. AM.QUEUE.HEADS 
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LINKING 

Structures within overlayable memory are linked together in two distinct lists, depending on their form. 
Although the linking system is basically similar, there are some differences as outlined below. 

AVAILABLE 

Each available block of memory contains within it a descriptor. This descriptor is five bytes long and 
is the first five bytes in the block. It contains type (available), size (physical), and absolute address 
of next available descriptor. The chain starts from the available head pointer which points to the avail- 
able table. This table contains one entry for each page of memory; thus, available memory linking is 
on a per-page basis. The entry in the table for each page points to the descriptor of the first piece 
of available memory on that page. The last available area on a page is linked to @FFFF@. 

WORK BLOCK/LINK BLOCK 

Each work or link block is immediately preceded by a three-byte descriptor indicating type and size. 
The main information about the block is held in a 10-byte descriptor. This descriptor also holds a 
pointer to the next descriptor in the chain. The head of the chain is pointed to by the "WB.LB Point- 
er." (Refer to figure 5-7.) 

It should be noted that the size may be indicated differently in the 10-byte descriptor and the three- 
byte descriptor. The three-byte descriptor contains "physical size," while the 10-byte descriptor con- 
tains "logical size." The discrepancy occurs as follows: 

1. Area of 200 bytes needed. 

3. Find available of 217 bytes. 

4. Since surplus bytes <5 (minimum requirement for "available" descriptor), use this area. 

5. Create and mark 3-byte descriptor with size -- 207 bytes (physical). 

6. Create and mark 10-byte descriptor with size = 203 bytes (logical) and pointer to start of area 
(not to 3-byte descriptor). 

NOTE 
Such a three-byte descriptor always immediately precedes the area it de- 
scribes. The 10-byte descriptor may be anywhere. 
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Figure 5-7. W.B./L.B. and Available Area Linking 
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SEGMENT TABLE 

AH OS data segments must reside on page 0. Code segments may be on any page. A segment table 
exists in the resident area for determining the presence and location of either structure. (Refer to figure 
5-8.) This table contains 136 entries which for any given release will be in the same order. It is indexed 
into by the segment number. Before accessing a segment, a test is performed on its descriptor to deter- 
mine if that segment is present. If so, its location in memory, held within the descriptor, is valid. 
If not, the disk address and size will indicate its location on disk. An absent segment will have a mem- 
ory address of @FFFF@. 
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Figure 5-8. Segment Table Block Diagram 
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jAQK PROCESSOR 

Communications between the OS and the TP take place through PI, except for movements of data 
which are initiated by a PI message but are performed by actions internal to OS or TP. 

Messages received from the input mailbox of the TP go to one of four functions. These functions are 
interpreter load, monitor, command handler, or data move. 

The interpreter load function is responsible for loading the interpreters at warmstart time. The monitor 
function handles polling from the OS. The command handler function breaks down its own parameters 
to determine the precise request being made by the OS. Data move is responsible for the movement 
of data between the OS and the TP. 

Responses to OS communications are returned to the OS by way of PI. The action in the OS to which 
the response is to be routed is part of the data contained in the output mailbox of the TP. 

The TP does not run with the same action structures as the OS. Only the interface mechanisms are 
common to both. The rest of the TP may be considered a completely separate entity. Figure 5-9 is 
a block diagram of the TP, showing the OS-to-TP interface, the TP functions, and the TP-to-OS inter- 
face, via PI. 

A task record is maintained for each TP task. Only two tasks are considered to be "resident" and 

MTNATF TA?S ta^#"'"t5^^ ^'''^"'u ^^^'^ ^^'^' ^'^ "^^^'^ "^^ REQUEST TASK" and "TER- 
MiWAlb I ASKS TASK. Entry numbers mdicating TP-relevant tasks are found in the JOB QUEUE 
A task is a pomter to a system task, and may be converted to a user mix number by use of the mix 
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Figure 5-9. Task Processor Job Control Activity 
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SECTION 6 
HEADING INFORMATION 
INTRODUCTION 

This section presents a description of the first four pages encountered in a system dump. The first page 
is the title page, which identifies the dump file being analyzed, and indicates when the dump was cre- 
ated. The second page, titled "Dump File Parameters," contains data detailing the structures found 
within the dump. Page three is a brief section containing dump file map definitions, and page four 
is the dump file map. The dump file map provides the status of the processors and associated memories 
at the time the dump was taken. The relevant fields in initial dump analysis are discussed in the fol- 
lowing paragraphs in the order in which they appear in the dump. 

TITLE PAGE 

The title page contains information relevant to the dump file being analyzed. The initiating message 
to the SYS ANALYZER program is printed first. This will indicate which portions of the dump were 
requested to be printed. The fields "dump file creation date" and "dump file creation time" can be 
used to determine if the dump was created by the ROM/PRAM routine or by the system. If these 
fields contain a valid date and time, the dump was created by the system. This could have occurred 
either automatically, due to a system failure, or by the operator's use of the GT MD intrinsic. If the 
date is given as 11 11 11 and the time is given as 24.00.00, the dump was most likely created by the 
ROM/PRAM dump routine. It is also possible that the failure occurred prior to the input of the date. 
On a remote SPO system it is not mandatory to enter in the date and time; therefore, the dump could 
contain 11 11 11 as the date and 24.00.00 as the time. Refer to figure 6-1 for an example of a title 
page. 



BOJ MESSAGE ALL, HEX 

DUMP FILE PACK ID OOUOOOO 

DUMP FILE ID SYSOMFILEOO 

DUMP FILE CREATION DATE 82 08 13 

DUMP FILE CREATION TIME 1A ^2 Ob 

ANALYSIS DATE 82 08 M 

ANALYSIS TIME 14 13 04 

REVISION LEVEL 03.04.10 



Figure 6-1. Title Page Messages 
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DUMP FILE PARAMETERS 

This area contains pointers to various structures within the operating system, most of which are used 
in a hexadecimal dump analysis. Some of the fields in the dump file parameters sections are irrelevant 
for an initial dump analysis. Those that are most important are: 

Version String 
System Error Value 
Frozen Processor 
Frozen State 

The dump file parameter fields are discussed in the following paragraphs in the order in which they 
appear in the dump file. Refer to figure 6-2 for a sample dump file parameter page. 

ANALYZER LEVEL 

The analyzer level is a one-byte field which is checked by SYSANALYZER. If the level in the dump 
file does not match the SYSANALYZER level, an analysis of the dump will not be performed. 

VERSION STRING 

This field identifies the level of the MCP in use when the dump file was created. 

SYSTEM ERROR VALUE 

This field gives the first two digits (byte) of the clearstart number if the dump was created by a clear- 
start (refer to Appendix A for clearstart numbers and their meanings); otherwise, the field contains 
@FF@. 

FROZEN PROCESSOR 

This field gives the bus address of a processor that has been frozen by the operating system. Other 
sections of the dump may show why the processor was frozen. 

FROZEN STATE 

The contents of this field indicate the state of the frozen processor identified in the preceding field, 
"frozen processor." The values for the processor state are found under "uump File Map Definitions." 
It should be noted that a fatal failure in a task or DC? processor always resuhs in an attempt to pro- 
duce a system dump file. 

PROCESSOR TYPES 

The processor types field is a 16-byte array. Each byte represents a zero-relative bus address. An 
unused entry contains @FF@. Vahd entries are described under Dump File Map Definitions. 

REMAINING DUMP FILE PARAMETERS 

The remaining dump file parameters are used for in-depth analysis, generally in conjunction with a 
hex dump. 
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DUMP FILE PARAMETERS 
******************** 



ANALYZER LEVEL 03 

VERSION STRING 3033 3034 3233 3033 3230 3130 3030 0304230 320100 

SYSTEM ERROR VALUE FF 

FROZEN PROtESSOR FF 

FROZEN STATE FF 

PROCESSOR TYPES FF01 0304 0303 0305 02FF FFFF FFFF FFFf 

DATE g TIME 0813 8219 1412 0572 

ACTION LIST POINTER 0A23 

NUMBER Of ACTIONS 64 

COMM BASE POINTER 0F5C 

CURRENT ID POINTER IISC 

VM BASE PAbt 1384 

VM BASE NGN PAGE 4B03 

WAITING HEAD POINTER 3024 

NORMAL HEAD POINTER 2F24 

QUEUE HEAD POINTER 3124 

NUMBER OF CRITICAL QUEUES OF 

LAST QUEUE POINTER 7E24 

NUMBER OF SCHEDULE QUEUES OD 

LONG DELAY POINTER 5B5C 

SHORT DELAY POINTER 3C5C 

UB/LB HEAD POINTER EA23 

WB/LB ENTRY SIZE OA 

AVAILABLE HEAD POINTER EC23 

AVAILABLE ENTRY SIZE 05 

SEGMENT TABLE POINTER C35E 

SEGMENT TABLE ENTRIES A7 

SEGMENT ENTRY SIZE 09 

INTERRUPT HANDLER POINTER B924 

INTERRUPT HANDLER SIZE OE 

MAX USER JOBS 20 

DC DATA POINTER 006A 

DC DATA END ADDRESS 566B 



DC POINTER POINTED 4966 

HISTORY COMM TABLE POINTER 8F46 

PI POINTER 1328 

ID WS 9D 

ID JM 9F 

ID DA PROG NAMTAB AO 

ID DA INTERP NAMTAB A1 

ID DA MISC NAMTAB A2 

ID DA LUAIT A3 

ID 01 A4 

10 SK A5 

DC LINE POINTER A6 

NUMBER OF EVENT QUEUES 21 

PORT TABLE POINTER EF64 

PERIPHERAL TABLE POINTER 3A65 

DA. CT. POINTER 4267 

ID DC LIST 51 

DA BUFFER POINTER DF66 

NUMBER OF PI QUEUES OF 

ODT SEG PTR 926F 

PERIPHERAL LOCKS 0857 



Figure 6-2. Dump File Parameters 
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DUMP FILE MAP DEFINITIONS 

The type key may indicate the type of area that is dumped, or it may indicate termination. The type 
key values are as follows: 

@01@: Page of memory 

@02@: Data block/work block/linked block area. Data block is part of the operating system's vir- 
tual memory file; work block/linked block are defined m Section 3. 

@03@: Terminated with no errors 
@04@: Terminated due to parity errors 

The validity flags and their meanings are: 

@FF@ Incomplete: The area that follows is the last area dumped, and is probably incomplete 

because of a system or disk crash. 

@00@ Valid: The area that follows has been completely dumped with no errors 

001(0) Invalid: The area that follows had disk errors during dump. Go on to the next id sector. 
The same area will be dumped again. Only one retry will be done before the dump 
is terminated and a type key of "terminated with parity errors" is written. 

The processor state values are outlined in figure 6-3. 

DUMP FILE MAP 

This table provides the status of all the processors and memories on the system at the time the dump 
was created- Using the fields bus address, processor type, and last address, the configuration of the 
svstem can be ascertained. The "Last Address" field is used to calculate the amount of memory as- 
signed to each processor. A normal 64K page will have the value @FOFF(a? ibyte-reversed), and for 
depopulated boards, the last address should be on a 16K boundary. If the last address is any value 
other than previously stated, it means that an error was detected when attempting to dump that page. 
The error being detected is at the address contained in "Last Address." The amount of buffer memory 
assigned can hi ascertained by a processor type of 05 (BM). In a ROM/PRAM dump, buffer memory 
is not evident. A dump file map is shown in figure 6-4; see figure 6-5 for an example of a processor 
status decode section. 
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************************* 
DUMP FILE MAP DEFINITIONS 
***»****♦***♦*»***»***«** 



TYPE KEY 



VALIDITY FLAGS 



PROCESSOR STATE 



01 - PAGE OF MEMORY 

02 - DATA BLOCK 

03 - TERMINATED UITH NO ERRORS 

04 - TERMINATED DUE TO PARITY ERRORS 



00 - VALID 

01 - INVALID 

FF - INCOMPLETE 



00 - FROZEN / REGISTER STATE SAVED 

01 - FROZEN / REGISTER STATE UNSAVED 

02 - UNFROZEN / SOFTWARE ERROR 
FF - O.K. 



Figure 6-3. Dump File Map Definitions 



************* 

DUMP FILE MAP 







BUS 


PAGE PROCESSOR PROCESSOR 


PROCESSOR 


LAST 


DISK 


KEY 


FLAGS 


ADDRESS 


ADDRESS STATE STATUS 


TYPE 


ADDRESS 


RECORD 


*** 


***** 


******* 


******* ********* ********* 


«•**•«*** 


******* 


****** 


01 


00 


01 


00 F 


F 810211B1 


OS 


01 


FOFF 


0003 


01 


00 


01 


01 F 


F S10211B1 


OS 


01 


FOFF 


0171 


01 


00 


01 


02 F 


F 810211B1 


OS 


01 


FOFF 


020F 


01 


00 


01 


03 F 


f 810211B1 


OS 


01 


FOFF 


044D 


01 


00 


02 


00 F 


F 81008FA2 


TP 


03 


FOFF 


05BB 


01 


00 


02 


01 F 


F 81O08FA2 


TP 


03 


FOFF 


0729 


01 


00 


02 


02 F 


F 81008FA2 


TP 


03 


FOFF 


0897 


01 


00 


02 


03 F 


F 81008FA2 


TP 


03 


FOFF 


OAOS 


01 


00 


03 


00 F 


F 81008F73 


DK 


04 


FOFF 


OB 73 


01 


00 


04 


00 F 


F 81008F64 


TP 


03 


FOFF 


0CE1 


01 


00 


04 


01 F 


F 81008F64 


TP 


03 


FOFF 


0E4F 


01 


00 


04 


02 f 


F 81Q08F64 


TP 


03 


FOFF 


OFBD 


01 


00 


04 


03 F 


F 81008F64 


TP 


03 


FOFF 


112B 


01 


00 


05 


00 F 


F 8ia28F05 


TP 


03 


FOFF 


1299 


01 


00 


05 


01 F 


F 81028F05 


TP 


03 


FOFF 


1407 


01 


00 


05 


02 f 


F 81028F05 


TP 


03 


FOFF 


1575 


01 


00 


05 


03 F 


F 81028F05 


TP 


03 


FOFF 


16E3 


01 


00 


06 


00 F 


F 81008F06 


TP 


03 


FOFF 


1851 


01 


00 


06 


01 F 


F 81008F06 


TP 


03 


FOFF 


19BF 


ai 


00 


06 


02 F 


F 81008F06 


TP 


03 


FOFF 


1B2D 


01 


00 


06 


03 F 


f 81008F06 


TP 


03 


FOFF 


1C9B 


01 


00 


07 


00 F 


F 21O0DF17 


BM 


05 


FOFF 


1E09 


01 


00 


07 


01 F 


F 21O0DF17 


BM 


05 


FF3F 


1F77 


01 


00 


08 


00 F 


F A1008F18 


DC 


02 


FOFF 


1FD4 


02 


00 


00 










FFFF 


2142 


03 


00 


00 










FFFF 


22D4 



Figure 6-4. Dump File Map 
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PROCESSOR STATUS OECOOE 



CROCESSOR ON BUS 01 

PROCESSOR ON BUS UZ 

PROCESSOR ON BUS 03 

PROCESSOR OH BUS 04 

PROCESSOR ON PUS Ob 
PROCESSOR ON BUS 06 
PROCESSOR ON BUS 0' 

PROCESSOR ON BUS 0« 



NPRC CONNECTED 


RAN STATE 


REHOTE ACCESS 


OS SUbSTSTEK 


lOS CONNECTED 


CONTROLS I/O 


NPRO CONNECTED 


RAH STATE 


LOCAL ACCESS 


OS SUaSTSTEir 


lOS CONNECTED 




NPRC CONNECTED 


RAH STATE 


LOCAL ACCESS 


DISK SUBSTSTEf 


10$ CONNECTED 


CONTROLS t/0 


NPRO CONNECTED 


RAH STATE 


LOCAL ACCESS 


DISK SUBSYSTEM 


lOS CONNECTED 




NPRO CONNECTED 


RAH STATE 


LOCAL ACCESS 


NPRO CONNECTED 


RAR STATE 


LOCAL ACCESS 


FROIEN 


RAH STATE 


LOCAL ACCESS 


R«n FEICH 


CONTROLS 1/0 




NPRO CONNECTED 


FROZEN 


RAH STATE 


RAH fETCH 


CONTROLS I/C 





RAH fETCM 

RAH FETCH 

RAH FETCH 

RAH FETCH 

RAH FETCH 
RAH FETCH 
READ WITH CLEAR 

LOCAL ACCESS 



Figure 6-5. Processor Status Decode 
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SC/^Ti/-\ivi -» 
tv^ I i^iSi / 

VIRTUAL MEMORY 

INTRODUCTION 

This section of the manual provides a field-by-field description of the Virtual Memory portion of a 
dump. This area of the dump is composed of six tables, which are maintained by the MCP, indicating 
the status of the system at the time the dump was taken. The tables are: 

DA_PROG_NAMTAB - Program Name Table 

DA_INTERP_NAMTAB - Interpreter Name Table 

DA_MISC_NAMTAB - Miscellaneous Name Table 

MIX TABLE 

PORT TABLE 

* ^"^trtlrsKAi^ i ArSLt (^1 HT^ - Penpiicrai Handhiig Table 

Lnuer neavy system activity, it is possible lOr some Oi these taules to be swapped out to disk (backing 
store). When this condition occurs, these tables are located towards the end of the SYSMCP file. In 
a system dump, both "Copy in Memory" and "Copy on Backing Store" are printed unless the tables 
have been swapped out of memory. When both are present. Copy in Memory is the most recent version 
and is the one which should be analyzed. Copy on Backing Store is never printed in a ROM dump. 
The reason for this is that the hnks which point to the location on backing store are cleared in the 
process of taking a ROM dump. 

Initial analysis of the Virtual Memory section consists of scanning the MIX TABLE, PORT TABLE 
and the Peripheral Table (PHT). 

An examination of the MIX table shows the number of programs in the mix and their status. More 
specifically, the "MIX PROCESSOR" field gives the bus address of the task processor executing a 
specific program. The Port Table identifies the devices on the "soft" ports. The PHT indicates the 
physical status of all peripherals connected to the system. This table should be used in conjunction 
with the Device Configuration Table (DA_CT), which gives the logical status of the peripherals. 

A detailed description of the virtual memory tables and their fields as they appear in a dump is contained 
in the subparagraphs which follow. 

DA_PROG_NAMTAB 

This table is a hst of all open code files. A sample DA_PROG_NAMTAB is supplied in figure 7-1. 

DA_INTERP_NAMTAB 

This table is a list of all loaded interpreters. A sample DA_INTERP_NAMTAB is supplied in figure 

DA_MISC_NAMTAB 

This table is a Hst of all opened miscellaneous files: for example, log files, SYSLANGUAGE, SYSDM- 
FILEnn, etc. Refer to figure 7-3 for an example of the DA_MISC_NAMTAB. 
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MIX TABLE 

The mix table is an internal array record of eacii job. It has one entry for each program in the system. 
The job management activity of the operating system controls the mamtenance of this table. The tol- 
lowing fields are used by Job Management in performing its functions. These fields appear in the dump 
analysis in front of the first mix table entry break down. 

Sample Mix Table entries are outlined in figures 7-4 and 7-5. 



MAX JOBS 



Th I s field I nd I cafes the max I mum number of 
Jobs (In hex) allowed In the mix. 



NULL MIX RUNNING 



This field Is set true (fFF«) If the 
current Job requires a null mix In which to 
run. 



JOB COUNT 



This field Indicates the number of Jobs In 
the mix. Including SUPER-UTILITY. 



MCS COUNT 



Contains the nunrt)er of MCSs running In the 
mix. 



TEMPORARY ID 



This field temporarily holds values during 
the loading of a Job. 



NEXT MIX NUMBER 



This field Is the mix number of the next 
Job to be loaded. 



COUNT WAIT JOBS 



This field contains the number of Jobs 
waiting to be assigned a processor to run 
In. 



RESTART ID 



This field contains the action Id of the 
restart action. 



INTERPRETER .^RRAY 0,1 



Thjs field contains the file Information 
block Ids of the Interpreter. 



SUPER FUNCTION 



This field contains the current SUPER- 
UTILITY function, such as PD. If the field 
Is blank, the SUPER-UTILITY Is Idle. 



The following fields are contained In a mix table record: 
MIX TABLE ENTRY/TASK ID 



PROGRAM FIB ID 



This field contains an Index Into the mix 
table. It points to the mix table entry 
for this Job (Itself). 

This field contains the Id of the file 
Information block for the program (code) 
file. It Is used In opening and closing 
the program file. The left hand byte Is 
the entry number In the DA_PROG_NAMTAB. 
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VM FIB ID 



INTERPRETER FIB ID 



MIX NuNGER 



MIX FLAGS 



This field contains the Id of the file 
Information block for the virtual memory 
file. It Is used In opening the VM file. 
The left hand byte Is the entry number in 
the virtual list and should be the same as 
the task Id. 

This field contains the Id of the file 
Information block for the Interpreter file. 
It Is used In opening and closing the 
Interpreter file. The left hand byte Is an 
Index Into the DA_INTERP NAMTAB. 

This field contains the mix number assigned 
to the task at load time. This Is the 
number the user uses to refer to the Job. 

Note that this Is In hex. 

These reflect the state of a Job. 

Any reasonable combination of these flags 
Is pennltted. 



i8000« : EOJ terminating 

i4000t : DP termt nation 

«2000« : DS terminating 

ilOOOi : Terminating (accompanied by 
one of the above) 

«0800t : BOJ/EOJ message suppress 

804008 : Data comm Job 

802008 : MCS 

801008 : Multicopy 

800808 : Thrashing 

800408 : Null mix required 

800208 : Paused 

800108 : Terminate with lock 
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•0008« : EX pending 

000040 : PR pending 

•00028 : ST pending 

100018 : GO pending 

•00008 : None of the above 



Mix Flags 2 



MIX STATE 



If this field = 01 then the task Is a 
ren»te SPO handler. 

This reflects the current state of the Job. 
possible values are: 



MIX PROCESSOR 



MIX INTERPRETER 



MIX PRIORITY 



8018 : Loading 

8028 : Waiting (not assigned to a TP) 

8038 : Awaiting run 

8048 : Executing 

8058 : Awaiting remove 

8068 : Stopped 

8078 : Unloading 

8088 : Awaiting suspend 

8098 : Suspended 

This field Indicates the processor which Is 
running this Job. 

This field holds the Index Into the 
Interpreter associated with this Job (Index 
Into Interpreter array). 

The low order digit of this field Indicates 
the priority of the Job as follows: 



1 : 


Priority C 


2 : 


Priority B 


3 : 


Priority A 


4 : 


Illegal priority 
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MIX TCB SIZE 



MIX PARENT POINTER 



REAL STORE 



SPO SIZE 



A 808 In the high order digit Indicates 
that this Job may open any file; 888 In 
this digit means this Job can open any file 
but system. 

This field Indicates the size of the task 
control block. It Is used by Job 
Management when passing the Job to the task 
processor to run. 

This field contains the task Id of the 
parent Job if this Job was started by a zip 
with pause. 

Holds the working set estimate specified at 
Job execution (If given). 

Reserved for future use. 



PORT TABLE 

This table lists the number of devices associated with a port and the number of users for the device 
and the actions executing for the port. 

The "index" is the index into the DA_CT table. DEVICES gives the number of devices associated with 
this port, thus the number of entries in the DA_CT, index 00 point to first entry in DA_CT. If 
DEVICES = 2, two entries will appear in DA_CT, both controlled by the controller indicated in port 
table TYPE column. 

NOTE 
Variations from above are devices that do not appear in DA_CT. They are: 



Entry 


00 


S 


PI 


Entry 


01 


= 


DP 


Entry 


02 


= 


TOO 


Entry 


03 


= 


OCT 



Refer to figure 7-6 for a sample Port Table. 



PERIPHERAL TABLE (PHT) 

This table contains device status information. The individual fields of an entry are explained below. 

The first grouping of four data items contains information about the disk file header locks. These locks 
prevent concurrent access to the disk file headers for a particular file during Open, Close, or Disk Area 
Allocation. Each lock is three parts: a SYSMEM flag, task byte, and a FILETAG. 

Refer to figure 7-7 for an example of a PHT entry. An explanation of the individual entries fol - 
lows: 
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PERIPHERAL TABLE (Cont.) 



NUMBER 

PERIPHERAL 

LXK 



This byte contains the nunnber of locks. This value Is 
used by the dump analyzer to cofnpute the sizes of the 
Individual lists that comprise the locks. This value 
Is the number of bytes In the SYSMEM flag and task byte 
lists and Is one-fourth the size of the lock byte list. 



SYSMEM 
FLAGS 



These flags are used by OPEN SYSMEM LOCK as an 
Indication that al I directory activity for a unit being 
locked has ceased. When Open wants to OPEN SYSMEM LOCK, 
the SYSMEM flag Is set («FF«) for each lock that is not 
available (an available lock has Its corresponding 
four-byte FILETAG entry In the lock bytes binary zeroed 
out). The Open delays until all of thes SYSMEM flags 
have been reset. It then continues with the Open. 



TASK BYTES 



The task bytes contain the Internal task number of the 
job that is currently holding a lock. When a lock Is 
freed, the lock maintenance code nsures that the task 
id of the lock holder matches the task id of the lock 
freer. If they do not match, a clearstart results. 



LOCK BYTES 



The lock bytes contain the FILETAGs for the flies 
that have currently locked headers. When Open, Close, 
or Allocate attempt to unlock or lock a file header, 
the FILETAG Is passed from the FIB. 



EHTRy/DA CT INDEX 



The contents of this field is an index Into 
the configuration table, DA CT. 



FORCE STATE STATUS 



This field Indicates whether the device is 
physically ready, physically not ready, or 
unavailable : 



eOOe : Physically not ready 
iOli : Physically ready 
eFF8 : Not available 



STATUS 



This field indicates the status of a 
device. The analyzer only lists this field 
for the devices that are marked physical ly 
not ready. The flag values are: 



(MSB) 
1 
2 
3 



Device post needed 
AVR needed 
Last status noticed 
Illegal PO flag 



UNIT/PORT TABLE INDEX 



This field Is an Index Into the port table, 
as follows. The righthand digit Is the port 
number and the lefthand digit Is the device 
number within that port. 
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PERIPHERAL TABLE (CONT.) 

QUEUE HEAD, 

TAIL, 4 CURRENT These fields poFnt to the queue of l/O's 

that are outstanding for this device. If 
the queue contains any entries, they are 
analyzed here. 

QUEUE STATUS This field reflects the status of this I/O. 

eOOi : New 

«01i : In process - by the controller 

6026 : Complete 

6036 : Complete and dequeued 

(delinked from queue but still 

In buffer memory) 

AM. ACTION. LIST INDEX This field contains the action Id of the OS 

action associated with this I/O. 

RETURN STATUS This is a three-byte field which Is the I/O 

status returned for the last operation 
performed. (This field Is only valid with a 
queue status of 2 or 3.) This field Is 
decoded as fol lows: 



MSB byte 1 : 6006 Ctontrol ler error (Internal to DP) 

6016 Command successful 

6026 (knunand unsuccessful 

6036 Device error, aborted command 

6046 Not used 

6056 Descriptor error 

byte 2 : 6006 No error 

6016 Seek timeout 

6026 Head off cylinder 

6036 Sequence error (Internal to DP) 

6046 Parity 

6056 Sector not found 

6066 II legal address 

6076 Status word error ( internal to DP) 
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PERIPHERAL TABLE (CONT.) 



tost Data error (In compare) 
«09i Write Inhibited 
byte 3 : Retry count 



OP CODE 



Th I s field conta I ns the op code of the 

command the device was executing. The 

following Is a list of acceptable I/O 
commands: 



Read data 

1 Write data 
3,4 Search less than 
5,6 Search greater than 
7,8 Search equal 



9,10 Search less than or equal 

11,12 Search greater than or equal 

13 Initialize 

14 Lock door 

15 Unlock door 

During a search operation the 2 bit Is used 
to condition read operations. If set, the 

hit sector will be read; If reset. It will 
not be read. 



BUFFER ADDRESS 



This Is a 6-byte field. The first two 

bytes Indicate size. The second two bytes 

Indicate BUS/PAGE, and the last two bytes 
Indicate offset. 



SIZE PARAMETER 



This Is a 2-byte 
buffer size. 



field Indicating total 



DEVICE-DEPENDENT 
PARATtTERS 



For Disk: 



Byte 1-3 Sector address 

4 Key length 

5 Key displacement 

6 Key record length 
7-9 MTR status 



For Tape Descriptor Format: 

The tape I/O descriptor differs from the 
disk I/O descriptor format In the Return 
Status fields, the CPCODE, and the Device 
Dependent Parameters. 

RETURN STATUS 

Byte 1 - Command Status 

8006 - I/O Control ler Error 
i01« - I/O Completed ok 
i038 - I/O Device Error 
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PERIPHERAL TABLE (CONT.) 



i04« - Tape Mark Read (end of file) 
iOSe - I/O Descriptor Format Error 
«06« - End of Tape Sensed 
«078 - I/O Complete with a Short Block 

Byte 2 - Error Status 

iOCfl - No Error 

«01« - Not Ready Error 

i02e - Parity Error 

«03« - Tape Hard Error 

i04t - Attempt to Backspeice over BOT 

»03t - Data Error 

fl06* - Attempt to Backspace over Tape Mark 

«078 - Device Timeout 

«088 - Attempt to Write to Write Disable Tape 

«09« - Gap Timeout 

eOA8 - Service Late Error 

By+e 3 - Retry Count 

OPCODES 

«008 - Read 
«01« - Write 
•02* - Write Tape Mark 
•036 - Skip to Tape Mark 
i04« - Read to Tape Mark 
«05i - Back Space One Record 
tost - Skip One Record 
e07i - Rewind With Walt 
808i - Rewind NC Walt 
«09« - Fixed Length Erase 
•0A8 - Backspace TO Tape Mark 
SOBS - Stream Dump 

Device Dependent Parameters 

Bytes 0,1 - Amount of Bytes short If a Read Encounters a 
short block. 
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************** 

VIRTUAL MEK.ORY 
************** 



************** 

DA PROG NAMTAB 
************** 



COPY ON BACKING STORE PACKIO ULENAWE ENTRY-NUKBER 

**** ** ******* ***** ******* ******** ************ 

COPY IN MEMORY PACKID FILENAME ENTRY-NUMBER 

**** ** ****** ******* ******** ************ 

0000000 SYS-SOPERUTL 00 



Figure 7-1. DA_PROG_NAMTAB 



**************** 

DA INTERP NAMTAB 
**************** 



COPY ON BACKING STORE PACKID FILENAME ENTRY-NUMBER 

**** *« ******* ***** ******* ******** ************ 

0000000 SYSHPLII 00 

0000000 SYSCOBOL 01 

COPY IN MEMORY PACKID FILENAME ENTRY-NUMBER 

««** ** ****** ******* ******** ************ 

OOOOOOO SYSHPLII 00 

0000000 SYSCOBOL 01 



Figure 7-2. DA_INTERP_NAMTAB 

************** 

DA MISC NAMTAB 
************** 

COPY ON BACKING STORE PACKID FILENAME ENTBY-KUMBER 

«*** ** ******* ***** ******* ******** ************ 

OOOOOOO SYSLANGUA6E 00 

OOOOOOO SYS-LOG-02 0? 

OOOOOOO SYS-LOG-03 03 

COPY IN MEMORY PACKID FlLEMAMt ENTRY-NUMBER 

**** ** ****** ******* ******** ************ 

OOOOOOO SYSLANGUAGE 00 

OOOOOOO SYS-LOG-01 01 

OOOOOOO SYS-L06-02 02 

OOOOOOO SYSDMIILEOO 03 

Figure 7-3. DA_MISC -NAMTAB 
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********* 

MIX TABLE 

********* 



COPY ON BACKING STORE 
**** ** ******* ***** 

MAX JOBS 

NULL MIX RUNNING 

JOB COUNT 

MCS COUNT 

TEMPORARY 10 

NEXT MIX NUMBER 

COUNT WAIT JOBS 

RESTART ID 

INTERPRETER ARRAY 

INTERPRETER ARRAY 1 

SUPER FUNCTION 



FF 



COPY IN MEMORY 
**** ** ****** 

MAX JOBS 1A 

NULL MIX RUNNING 00 

JOB COUNT 01 

MCS COUNT 00 

TEMPORARY ID OC 

NEXT MIX NUMBER OD 

COUNT WAIT JOBS 00 

RESTART ID OB 

INTERPRETER ARRAY 0301 

INTERPRETER ARRAY 1 030C 
SUPER FUNCTION 



Figure 7-4. Mix Table - Copy on Backing Store 



MIX TABLE ENTRt / TASK ID 


00 


PROGRAM FIB ID 


0100 


Vn FIB ID 


0400 


INTERPRETER FIB ID 


0300 


MIX NUMBER 


01 


MIX FLAGS 


0000 


MIX FLAGS? 


00 


MIX STATE 


04 


MIX PROCESSOR 


02 


MIX INTERPRETER 


01 


MIX PRIORITY 


cz 


MIX TCB SIZE 


7F02 


MIX PARENT POINTER 


00 


REAL STORE 


0000 


SPO SIZE 


ooou 



00 00000/ SYS -SUP ERUTL 
OOUQOOO/SYSMPLII 



EXECUTING 



PRIORITY 8 



CAN OPEN ANYTHING 



Figure 7-5. Mix Table - Copy in Memory 
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7-11 



I 

to 



PORI-TABL E 









USER 


ACTION 






A«. ACTION. LIST 


ENTRY 


INDEX 


DEVICES 


COUNT 


TYPE 






INDEX 


***** 


***** 




***** 


****** 








0000 




uo 


00 


00 










0001 


00 


06 


00 


03 


DA 


DP 


CONTROL 




0002 




00 


00 


00 










0003 




00 


00 


00 










0004 


06 


01 


00 


56 


DA 


LP 


CNTRL 




0005 




00 


00 


00 










0006 




00 


uo 


00 










0007 




OA 


00 


73 


DA 


KT 


CNTRL 




0008 




00 


00 


00 










0009 




00 


00 


00 










OOOA 




go 


00 


00 










OOOB 




00 


00 


00 










OOOC 




00 


00 


00 










OOOD 




00 


00 


00 










OOOE 


00 


00 


DO 


00 











Figure 7-6. Port Table 



00 

00 



********************** 
PERIPHEh«L lABLt PHT 
********************** 



NUKSEP PERIPHERAL LOCKS OA 

SYSftr' FLAGS OflOD C;OUO OOOO DUoO UJiJlJ 

TASK BYTES IjCGU DOUO QUUO OOUU OOUO 

LOCK BYTES POQO (JOUO UuCD UCiOC OOOL Ut,(jO (iClOC OOOCI OOOU OUOC 0000 0000 OOLO 0000 UC'OO OOOJ 

OUOQ OOJO COOU OOCjO 



Ek TRY/DA CT INDEX 

FORCE STATE STATUS 

STATUS 

UNIT/PORT TABLE INDEX 

aUEUE HEAO 

OL'EUE TAIL 

QUEUE CURRENT 



ENTRY/DA CT INDEX 

FORCE STATE STATUS 

STATUS 

INIT/PCRT TABLE INDEX 

QUEUE HEAO 

QUEUE TAIL 

QUEUE CURIiENT 



ENIRY/DA CT INDEX 

FORCE STATE STATUS 

STATUS 

UNIT/PORT TABLE INDEX 

QUEUE HEAD 

QUEUE TAIL 

QUEUE CURRENT 



ENTRT/DA CT INDEX 

fORCE STATE STATUS 

STATUS 

UNIT/PORT TACLE INDEX 

QUEUE HEAD 

QUEUE TAIL 

QUEUE CURRENT 



ENTRY/DA CT INDEX 

FCRCE STATE STATUS 

STATUS 

UNIT/PORT TABLE INDEX 

QUEUE HEAD 

QUEUE TAIL 

QUEUE CURRENT 

QUEUE STATUS 

AH. ACTION. LIST INDEX 

RETURN STATUS 

FORWARD LINK 

BACKWARD LINK 

OP CODE 

BUFIER ADDRESS 

S12E PARAHETER 

DEVICE DEPENDENT PAKAMETERS 



CO 




00 




DO 




03 




f FFF 


FFFF 


FFF) 


FFFF 


F Ff F 


FFFF 


01 




CO 




00 




03 




FFFF 


FFFF 


FfFI 


FFFF 


FFII 


FFFF 


0? 




00 




00 




04 




FFFF 


FFFF 


FFFf 


FFFF 


FFFf 


FFFF 


OJ 




00 




00 




04 




FFI F 


FF FF 


FFFF 


FFFF 


FFFF 


FF FF 


04 




01 




04 




Oi 




0001 


?iAE 


0001 


?SAf 


0001 


?5A8 


01 




111 




0100 


00 


FFFF 


FFFf 


FFFF 


FFFF 


01 




Fid 


0001 ouoo 


F1FI 




0?43 


D?OZ 0004 FFF 



DEWlCt PHYSICALLY NOT READY 



DEVICE PHYSICALLY NOT READY 



DEVICE PHY:>ICALLY NOT R(l«Dt 



DEVICE PHYSICALLY NOT READY 



DEVICE PHYSICALLY READY 



cobhano cokplete 



WRITE 



NO EKROK 



-J 
I 



Figure 7-7. Peripheral Table 



SECTION 8 
OPERATING SYSTEM 
INTRODUCTION 

The Operating System section of the dump examines the structures within the MCP. This portion of 
the dump file provides a history of what the MCP was doing before the dump was taken, and shows 
what section of the MCP (if any) detected an error. 

The Operating System portion of the dump file is subdivided into the following sections: 

ACTIVITIES 

AM.ACTION.LIST 

AM.QUEUE.HEAD 

SEGMENT TABLE 

HISTORY COMMUNICATE TABLE 

PI DATA 

DEVICE CONFIGURATION TABLE (DA_CT) 

WB.LB.HEAD - Work Block/Link Block Head 

FIB - File Information Block 

AVAILABLE TABLE - Available Table Map 

OVERLAYABLE MEMORY - Overlayable Memory Map 

AVAILABLE MEMORIES - Available Memory Map 

ODT DATA SEGMENT 

INITIAL DUMP ANALYSIS 

In an initial analysis of the OS section of the dump, these are the sections to be considered: 

ACTIVITIES 

AM.ACTION.LIST 

HISTORY COMMUNICATE TABLE 

PI DATA 

DA_CT 

The remaining sections are explained in the order in which they appear in the dump. 

ACTIVITIES 

This is the area in which the processor register values are saved when a failure is detected. If a clear- 
start occurs, the clearstart number appears in the ERROR NUMBER field. (Refer to Appendix A for 
an explanation of these error numbers.) This information gives a general idea of what caused the clear- 
start. 

The fields ACTION ID and ACTION NAME contain the ID and the name of the action that is in 
error. If these fields contain @FF@ and the other register values are @00@, then the OS processor 
did not detect an error and therefore was not the reason for the dump to occur. 

NOTE 
If an action was marked "IN ERROR," it does not necessarily mean that 
this action had failed. It may mean, instead, that this was the action that de- 
tected the error. For example, this action may have picked up bad data from 
some other area of the MCP, or read an area of corrupted memory. 
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The MAX register is the next entry to be checked. This register is explained further in figure 8-1. It 
contains the bus address and the page of the processor that the OS processor was accessing at the time 
of the failure. If the OS processor detects a memory error, that error may be in any of the processors 
attached to the system. This is because any processor can access any other processor via the Processor 
Interface Bus. 

The IC Status Word fields should be interrogated next. These words identify the status of the processor 
and the type of failure which occurred. Refer to the IC Memory Map, figure 8-2. 

The IC FIRST ERROR REGISTER identifies the memory address within a page of memory that the 
processor was addressing at the time of the failure. In the case of a memory parity error, this register 
contains the address of the failing memory. 

AM. ACTION. LIST 

This area interprets the status blocks of all the actions that were active prior to the dump being taken. 
If the problem was a clearstart, the ACTION ID and the ACTION NAME found in the STATE SAVE 
AREA identifies the action in error. The status block of this action contains pertinent information. 
More specifically, the Caller Field within the status block contains the action number of the action 
that invoked it. This may help to identify the reason for the failure. 

The LINKl and LINK2 fields identify the sequence of events leading up to the clearstart. 

The last field to interpret in the initial analysis of this section is the TASK ID/MIX TABLE INDEX. 
This field identifies the task in the MIX Table on whose behalf the action was running. A @20@ in 
this field indicates that the action was invoked by a system resource. 

nio I UnY UL/iviiviuimioaa i [^ i aaduc 

This table identifies the last 10 communicates performed. The table is cyclic, the highest entry number 
is the item which occurred most recently. 

This information is useful as it indicates the type of I/O the system was performing before the clear- 
start occurred. 

For example, if heavy disk I/O had been occurring, it is possible the failure is in the disk area. 

PI DATA 

In this section of the dump file, the PI DEAD PROCESSORS field indicates any "dead" processors 
on the system. The field is byte-reversed and bit-oriented. 

For example, if a task processor on bus address 5 had been frozen for some reason, this field contains 
1000. When this is byte-reversed it becomes 0010, the fifth bit being set. This indicates the processor 
on bus address 5 is frozen. 

DA_CT 

This table provides the logical status of the peripherals on the system. This information is used in con- 
junction with the Peripheral Handhng Table to determine both the physical and logical status of the 
peripherals. 

The other fields in the Operating System portion of the dump file are used for more in-depth analysis 
of errors. The method, of using them is explained in detail in the remainder of this section. 
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Byte 

1 

2 

3 

4-5 

6-7 

8-9 

10-11 

12-13 

14-15 

16-17 

18-19 

20 

21 

22-29 

30-35 

36 

37-38 

39-40 

41-42 

43-44 

45-46 

47-48 

49-50 

51-52 

53 

54 

55 

6G 

57 

58 

59 

60 

61 

62 



Description 

Clearstart/TP/DCP/OS Error No. 

AM ACTION LIST entry No. 

Action Name in error 

IV11 Register 

WR Register 

l\/12 Register 

B32 Register 

IVIAX Register 

IVIXA Register 

MXB Register 

B1FL Register 

BO Register 

REQ Register 

XY Register 

J,K,L Registers 

AD Register 

Top of stack (UIV1R3) 

Top of X stack (UIVIRX3I 

2nd on stack IUIV1R4) 

2nd on X stack (UI\/IRX4) 

3rd on stack (UIV1R5) 

3rd on X stack (UIV1RX5I 

Bottom of stack (UIVIR6) 

Bottom of X stack (UIV1RX6) 

IC Error Status 

IC Status 1 

IC Status 2 

IC Sialus 3 

IC Status 4 

IC Status 5 

MA Lines Least Significant Byte 

MA Lines Most Significant Byte 

XMA Lines Least Significant Byte 

XMA Lines Most Significant Byte 



Length 




Byte 


In Bytes 


Note 


Reversed? 


1 


1 




1 


1 




1 


1,2 




2 




Yes 


2 




Yes 


2 




Yes 


2 




Yes 


2 


3 


Yes 


2 




Yes 


2 




Yes 


2 




Yes 


1 






1 






8 




Yes 


6 




Yes 


1 






2 




Yes 


2 




Yes 


2 




Yes 


2 




Yes 


2 




Yes 


2 




Yes 


2 




Yes 


2 


3 

3 

3 

3 

3,4 

3,4 

4,5 

4,5 

4,5 

4,5 


Yes 



Notes: 

1. Task Processor Error Numbers are defined in Appendix B. 
Clearstart Numbers are defined in Appendix A. 

2. This field will contain a 00 or FF for Task Processor entries. 
The AM ACTION LIST names are listed in table 8-1 . 

3. See figure 8-2. 

4. This field will contain FF on 1 MHz. processors. 

5. This field is known as the FIRST ERROR Register. 



Figure 8-1. Format of Processor State Save Area 
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NAME 


PAGE 


ADDRESS 


MSB 7 


6 


5 


4 


3 


2 


1 


LSB 


(C STATUS 1 





FFFB 


PROC 
AVAIL 


2ND 
ERROR 


FREEZE 


ROM 


REO 
1 


REG 






PG1 
STATUS 


RAM 


ERROR STATUS 





FFFC 


2ND 
ERROR 


ERROR 


READ 
PARITY 


WRITE 
PARITY 


BOUND 
ERROR 


MEM 
LIMIT 


DATA 


WRITE 


MKRD 


READ 


IC STATUS 3 





FFFD 


LQCAL=1 


READ 
WITH 
CLEAR 


ROM 


IC 
ENABLE 


1 1 

BUS ADDRESS 

8 4 2 1 


REMOTE 


RAM 


IC STATUS 2 





FFFE 


POSS 

OS 
PROC 


POSS 
DISK 
PROC 


lOS 
AVAIL 


CONTRL 

OF 
PERIPH 


BUS ADDRESS OF THIS 
8 4 2 


C 

1 


IC STATUS 4 




FFF9 


2ND 
ERROR 


BUS 
CNTRL 
FREEZE 


FRZ2 
SET 


MOM 

FRZ 

(NOT USED) 


REFRESH 
FREEZE 


1-0 
FREEZE 


CLEAR 

FREEZE 


CMND 
FREEZE 


IC STATUS 5 




FFFA 


7 


MTR 
PARITY 


BUS 
REFRESH 


MANDA- 
TORY 
REFRESH 


OPPOR- 
TUNISTIC 
REFRESH 


BUS 

DEST 

FREEZE 


SYNC 
FREEZE 


BUS 

REG 

FREEZE 


MALSB 




FFFC 


MA 

7 


MA 
6 


MA 
5 


MA 
4 


MA 
3 


MA 
2 


MA 
1 


MA 



MA MSB 




FFFD 


MA 
15 


MA 
14 


MA 
13 


MA 
12 


MA 
11 


MA 
10 


MA 
9 


MA 
8 


XMA LSB 




FFFE 














XMA 
3 


XMA 
2 


XMA 

1 


XMA 



XMA MSB 




FFFF 


XMA 
15 


XMA 

14 


XMA 
13 





XMA 
11 


XMA 
10 


XMA 
9 


XMA 
8 

















MAX 












ROM 


RD 
WITH 
CLEAR 


IC 
EN 





B U 
8 


S A [ 
4 


1 D R E 
2 


s S 
1 










1 

PAGE 
8 4 


1 

SELECT 

2 1 







IC 




















1 

PAGE 


i 

SELECT 



































































8 


4 


2 


1 



Figure 8-2. IC Memory Map 
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ACTIVITIES 

STATE SAVE AREA 

For each processor on a B 900/B 5900 system, there is an area in the dump known as the State Save 
Area. This area is used to store the contents of the NPRO registers and IC registers at the time a 
failure is detected within that processor. For initial dump analysis, this area is one of the most impor- 
tant areas for the purpose of identifying the cause of a failure. The important fields in this area are 
listed in the introduction to this section. 

If no error is detected by a specific processor, the contents of these registers are: OS, DCP, and Disk 
Processor: the first three bytes are @FF@, the register values are 0. Task Processor: the State Save 
Area address is 0, the area is not printed. 

The format of the State Save Area is detailed in figure 8-1. An example of the State Save Area is 
presented in figure 8-3. This information is also contained in the maintenance log file. Refer to 
B 900/B 5900 F. E. Handbook, form 1127297, for the format of maintenance entries. 

AM.ACTION.LIST 

This structure is a list of status blocks associated with actions awaiting processor time or an external 
event. The information contained in a status block is as follows: 



ENTRY NUMBER 



This Information Is formulated by the system 

dump analyzer. It Is the Index Into the action 

list. This Index Into the action list Is the 
action Id. 



STATUS BLOCK ADDRESS This Information Is formulated by the system 
dump analyzer. It Is the OS memory address of 
the status block. 



COMM AREA 



This Is the area which Is used 
Information to other actions. 



to communicate 



TASK ID 

MIX TABLE INDEX 



This field contains the task Id of the Job on 
whose behalf this action Is executing. §206 
denotes that the action Is on behalf of a system 
function, not a task function. 



PARAMS 



This field contains the parameters which were 
passed to activity management by the action. If 
the status of this action Is "WAITING REPLY," 
the second byte of this field will contain the 
Action ID of the action Invoked by this action. 



TIME 



This field contains the time of day at which the 
action was started (hour, minute, second, 
hundredths). 



NAME 



This field contains the name of the action which 
owns the status block. Table 8-1 Is a complete 
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***«•« OPERATING SYSTEM ****** 
****************************** 



********** 

ACTIVITIES 
********** 



STATE SAVE AREA 






STATE SAVE AREA ADDRESS 


C7?A 




ERROR NUMBER 


Ff 




ACTION ID 


FF 




ACTION NAME 


FF 




Ml 


0000 




UR 


OCOO 




M2 


0000 




B32 


0000 




MAX 


0000 




MXA 


0000 




HXB 


0000 




BIfL 


0000 




BO 


00 




REQ 


00 




xv 


0000 0000 onco 


onnii 


J 


0000 




K 


0000 




L 


0000 




AD 


00 




TOP Of STACK 


oooa 




TOP OF XSTAtK 


0000 




ZNO ON STACK 


0000 




Zno on XSTACK 


0000 




3RD ON STACK 


0000 




3RD ON XSTACK 


0000 




BOTTOM or STACK 


000 




BOTTOM OF XSTACK 


0000 




IC - ERROR STATUS 


00 




IC - STATUS WORD 1 


00 




IC - STATUS WORD 2 


00 




IC - STATUS WORD 3 


00 




IC - STATUS WORD A 


FF 




IC - STATUS WORD 5 


FF 




IC - FIRST EfcROR REG 


FFFF FFFF 





END OF LIST EXCEEDED 



Figure 8-3. Sample of Beginning of Operating System Portion of a Dump 
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AM.ACTION.LIST ENTRIES (Cont.) 



list of possible values and the action they 
denote. The analyzer prints the appropriate Id. 



CALLER 



This field contains the action Id (Index Into 

AM.ACTION.LIST) of the action that Invoked this 

action. iFF« = invoked without wait, «00i = TP 
Invoked. 



SB STACK OFFSET 



This field contains the offset 
stack frame (see glossary). 



of the current 



This Is a pointer from beginning of "comm area" 
to a location In the stackframe. This may 

At'fhAr Ka mc nn Q-ffgo^ Qp » mSRCr^' ad'^*"'^'*'** 

This may be determined by the value, since 
stackframes are required to be kept small. 
Typically, If the value Is displayed as nnOO 
(byte reversed = OOnn) this would be an offset. 
If an action Is In use, or recently used, one 
would see an address. (Conventionally, on yield 
this value would be returned to an offset. 



LIhKI 

LINK2 
STATUS 



This field contains the scheduling link. That 
Is, the action Id (Index Into AM.ACTION.LIST) of 
the next action on the scheduling list. 

This field contains the suspension link. 

This field contains the status of the action. 
The possible contents of this field are shown 
below. The field Is also Interpreted by 
SYS ANALYZER. 



Value Status 



Value 



Status 



eooe 


Available 




eoi« 


Waiting reply (waiting 
for an Invoked action) 


80B8 


eo2« 


Waiting critical action 


80C8 


8038 


Waiting VM action 




8048 


Watting VM reply 




8058 


Waiting post (waiting 
for an action In OS to 
post a reply) 


80D8 


8068 


Long delayed 


80E8 


8078 


Short delayed 


80F8 


8068 


Waiting Interrupt 


8108 


8098 


$$$ IN ERROR $$$ 


X8108 



Waiting Conditional Post 

(waiting for a task processor 

to finish) 

Lonely wait (waiting to become 

the only action running; used 

with "GT MD".) 

Event wait 



Waiting mailbox 

Waiting processor (waiting for 

an Interrupt from a task 

processor) 

Ready 

Inval Id 
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Table 8-1. Status Block Action Name Values 



Value 


Action 


01 


AM VM 


02 


AM_RTC 


93 


OA DP CONTROL 


04 


DA OSVMIO 


05 


DA ERRL0GGIN6 


06 


MN LOG INIT 


07 


MN PROC POLL 


08 


DC RSLT FN 


09 


DC LOAD 


OA 


DC_EOJ 


OB 


JM RESTART 


OC 


AM SYSTEM_ERR 


OD 


MN QUICK LOG 


OE 


FUTURE USE 


OF 


P! SEND 


10 


PI RECEIVE 


11 


MN LOG_iR 


12 


JM EX 


13 


01 ACCEPT 


14 


01 ZIPDISPLAY 


15 


01 SYSMESSAGE 


16 


01 AX 


17 


01 REQUESTS 


18 


01 ROUTING 


19 


01 SYS STATUS 



Value 


Action 


1A 


AM UNIMPLCOMM 


IB 


DA RD 


1C 


DA_AD 


ID 


DA CL 


IE 


UN IMP SOL 


IF 


DA OL 


20 


DA PG 


21 


DA PO 


22 


DA RY 


23 


DA SF 


24 


DA SN 


25 


DA_SV 


26 


DA RTN DEVICE 


27 


DA_CMS START 


28 


OA_CMS_RWRITE 


29 


DA CMS READ 


2A 


DA CMS WRITE 


2B 


DA CMS DELETE 


2C 


OA_CMS_STRMIO 


2D 


DA CMS OPEN 


2E 


DA_CMS_aOSE 


2F 


DA SYSOPEN 


30 


DA SYSIO 


31 


DA_SYSCLOSE 


32 


OA ADDAREA 



Value 


Action 


33 


DA DUMPTOVM 


34 


DA SYSPRINT 


35 


DA FILESEND 


36 


DA LPCNTL 


37 


DA M DK CNTL 


38 


MN TRAP INIT 


39 


MN TRACE INIT 


3A 


MN TRACE STOP 


3B 


MN PRX STATS 


3C 


MN SWITCH 


3D 


MN MEM DUMP 


3E 


DC VERB30 


3F 


DC VERB31 


40 


DC VERB32 


41 


DC VERB33 


42 


DC VERB34 


43 


DC SPG 


44 


JM MIXACCESS 


45 


01 Sa LOGON 


46 


DA NAME FIBID 


47 


JM JOB RUNNING 


48 


JM JOB REMVED 


49 


JM GO 


4A 


JM PR 


4B 


JM STOP 



Table 8-1. Status Block Action Name Values (Cont.) 



Value 


Action 


4C 


JM DS DP 


4D 


JM THRASHING 


4E 


JM DC JOBREM 


4F 


DC VERB3F 


50 


AM_WAIT 


51 


DC_JOB_LCG 


52 


JM TP ERROR 


53 


AM_TIMER 


54 


DA_CMS TST ST 


55 


JM_PAUSE 


56 


AM DT 


57 


AM DATE TIME 


58 


DA RES AVR 


59 


AM_CMS ERROR 


5A 


DAJLP_AVR 


5B 


DA_DK AVR 


5C 


DA ICMD AVR 


5D 


DA HSP CNTRL 



Value Action 

5E JM_SUP_ACCEPT 

5F JM_EOJ 

60 JM_MIX 

61 OI_DCI_INT 

62 OI_ODT_DCI 

63 DA_GET_DC_MEM 

64 DA_SO 

65 DA_TO 

66 PI_DeAD_PROC 

67 OI_SCL_READO 

68 OI_Sa_RUN 

69 OI_Sa_LOGOFF 
6A OA_REDEF_READ 
6B DA_RL 

6C DA_AP 

6D MN_LOG_LG_LS 

6E DA_VF 

6F DA MERGE 



Value Action 

70 DA_RUF_GEN 

71 DA_DEV_STATS 

72 DC_DCP_ERROR 

73 DA_MT_CNTRL 

74 DA_MT_AVR 

75 DA CT CNTRL 

76 DA_CT_AVR 

77 DA_CHNG_REEL 

78 JM_SPO_SIZE 

79 DA_INIT_TRK 
7A AM_CMPLX_WAIT 
7B DC_TSTEVNT 

7C OI_TEST_SCL_Q 

88 PI_REVIVE 

89 DA_|0_L1M<ER 
8A MN_HOOKUP 

8B MN DUMMY 
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AM.ACTION.LIST ENTRIES (Cont.) 



PRX.WB 



EVENTS 



This field contains the associated processor bus 
address number In the high order digit. means 
It was Invoked at WARMSTART. The number of 
assigned work blocks In the low order digit 
uses bit pattern 1 bit per WB, not binary count. 

Control Information pertaining to the action 
associated with the status block. This field Is 
used by activity management. Valid when the 
action Is watting on an event or when the action 
caused an event. If this field contains IFF8, 
the event has occured; If this field contains 
«00i, the event has not yet occured; If this 
action caused an event, then this field contains 
the event number. 



EVENT TASK 



ATTACHED OWNER 



ATTACHED ID 
ATTACHED TYPE 

ATTACHED BASE 



This field contains the task Id associated with 
the event described In the previous field; but 
It Is only used If action enabled event. 

The owner of the attached data structure. If 
the attached type Is a work block or a data 
block, this Is an action ID. If the attached 
type Is a link block, this Is an action list 
name. 

The ID of the attached data structure. 

The type of the attached data structure. This 
Is either a work block (00), a link block (01), 
or a data block (05). 

The memory address of the attached data 
structure. 



SB SPO ID 



Reserved for future use. 



SB SPO TAG 



Reserved for future use. 



VMREO 



This field contains the last virtual memory 
request. Only valid when waiting on VM. 



PI REQUEST FUNCTION, 
PI REQUEST PROCESSOR, 
PI RESPONSE PROCESSOR, 
PI RESPONSE FUNCTION, 
PI MIX NUMBER 



Original processor request links. More detail 
will be found In 10, Task Processor. 



PJ RESULT, 
PI FLAGS 



These are the result areas for Interprocessor 
communications. More Information can be found 
in section 10» Task Processor. 
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AM.ACTION.LIST ENTRIES (Cont) 



STACK ENTRIES These fields are duplicated for additional 
stackframes and If the outer level declares no 
local variables. A sample status block entry Is 
shown In figure 8-4. 

SEG^CNT NO Field containing the segment number within 
the MCP file. Refer to the Segment Table. 

SEGMENT OFFSET Contains the return address (offset within 
the segment). 



Ij^ST.L 



Contains the location of the calling segment 
number In the stack frame. (Not valid for 
outer level.) 



NUMBER OF Contains the number of parameters In use by 
PARAMS the stack frame. (Not valid for outer level.) 

ADDR OF PARAMS Contains the address of the parameters in use. 



LOCAL 
VARIABLES 



Local variables used by the action. The number 
and type are determined by the procedure in use. 



AM. QUEUE. HEAD 



This structure is an array of queue heads for system resources. The array is decoded by the system 
dump analyzer by queue name and queue contents. The queue contents are shown as a hst of action 
IDs (mdex mto the AM.ACTION.LIST). An empty queue is shown as having a single emry of @FF@ 



AM.LAST. QUEUE 



AM.WAITING.HEAD 



AM. NORMAL. HE AD 



This field gives the memory address of the head 
of the last queue to be serviced. Currently 
(3.04) this address Is not Interpreted. 

This field is a pointer to a list of actions 
waiting to start. The analyzer lists the action 
Ids of all actions currently In the waiting 
list. A single entry of «FFa In the 
AM.WAITING.HEAD field signifies that the list of 
waiting actions Is empty. 

This field Is a pointer to an action which Is 
the top of a circular list. The analyzer lists 
the whole circle which Is a set of action ids. 



AM.LONG.DELAY 



AM. SHORT. DELAY 
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This field is a pointer to actions which have 

been delayed for seconds. The analyzer lists 

all such actions. A single entry of «FFi 
Implies an empty list. 

This Is a pointer to a list of actions which 
have been delayed for milliseconds. The 
analyzer lists the Ids of all such actions. A 
single entry of eFFS Implies an empty list. 
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00 
I 

to 



************** 
AC. ACTION. LIST 
************** 



ENTRY-NUKBER 00 

STATUS BLOCK ADDRESS fH7 

COr«|il G301 OOCO 02o9 <40U 0000 0000 OCOO 090? 

TASK ID / «IX TABLE INDEX 20 

PARAKS OOOU Oil 

Jifi 1A11 50U0 

NAME SP MN DUrHY 

CALLER ft 

SB. STACK. OFFSET 2 71 « 

L1NK1 FF 

L1NK2 FF 

STATUS 10 READY 

PROC.UB ?0 

EVENTS 00 

EVENT TASK 00 

ATTACHED OUNER 00 

ATTACHED ID FF 

ATTACHED TYPE 00 

ATTACHED BASE 0000 

SB SPO ID 00 

SB SPO TAS 0000 

VHREO 0000 

PI SEQUEST FUNCTION SB 

PI REQUEST PROCESSOR 01 

PI RESPONSE PROCESSOR 0? 

PI RESPONSE FUNCTION FF 

PI MIX NUMBER 20 

PI RESULT 00 

PI FLAGS 00 

STACK ENTRIES 
***** ******* 

SEGMENT NO 00 

SEGMENT OFFSET 216E 



lAST.L 0625 
NUMBER OF PARAMS UO 
ADDR OF PABAMS 
LOCAL VARIABLES 



0000 0000 0000 GOOD 0000 0000 0000 0000 0000 noon 0000 0000 OOpO 0000 OU 0000 
OOOU 0000 0000 0000 0000 OOUO 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 
0000 0000 OCOO 0000 0000 0000 liOOO 0000 OOUO OOOO 0000 0000 OOOD 0000 0000 0000 



OOQO DUOO 



Figure 8-4. Status Block Entry Example 



SEGMENT TABLE 

This structure is an array of code and data block descriptors. The analyzer decodes each descriptor 
of this table for the user. The descriptors indicate the segment's ID, frozen/jelled count, size, disk ad- 
dress, present/access/type, memory address, and page. 

HISTORY COMMUNICATE TABLE 

This table is a trace of the last ten communicates received by the OS. Each table entry comprises the 
following fields: 



ENTRY 



This field contains a nuntier Incremented by 1. 
Its purpose Is to show the order In which the 
communicates were received^ 



I nof\ lu 



This field is an index into the mix table* 
Using this infonnatlon along with the mix table 
will reveal which Job Issued the conununlcate* 



BUS ADDR 



This field Indicates the processor which was 
running the task that Issued the communicate. 



VERB 



This parameter Is held In byte of the CPA and 
Is used to Indicate which of the possible 
functions Is required. It may take values In 
the range - 255. For full details see the CMS 
MCP MANUAL. The current list of CMS 
coiimunlcates Is given below: 



01 


: OPEN 


40 


: DATE-TIME 


02 


: aOSE 


41 


: TERMINATE 


11 


: ZIP 


42 


: WAIT 


12 


: DISPLAY 


43 


: SYSTEM STATUS 


13 


: ZIP 4 DISPLAY 


50-6F 


: RESERVED FOR EXPANSION 


14 


: PAUSE 


70-7F 


: RESERVED FOR SYSTEM UTILITY FUNCTIONS 


15 


: ZIP 4 PAUSE 


80 


: TEST STATUS 


16 


: DISPLAY 4 PAUSE 


82 


: READ (NOT CONSOLE) 


17 


• ZIP, PAUSE 4 DISPLAY 


84 


: WRITE (NOT CONSOLE) 


1A 


CONDITIONAL DISPLAY 


86 


: REWRITE 


IB 


ZIP 4 CONDITIONAL DISPLAY 


88 


: DELETE 


1C 


DISPUY WITHOUT LOGGING 


8A 


: STREAM CONTROL 


20 


ACCEPT 


8C 


: START 


21 : 


SUPER.ACCEPT 


8E 


: OVERWRITE 


30 : 


MCS CONTROL COMMUNICATE 


90 


: READ-WRITE 


31 : 


MCS INTERROGATES 


92 


: READ (CONSOLE) 


32 : 


MCS REDEFINITION 


94 


: WRITE (CONSOLE) 


33 


: USER DATA COMM 


96 


: GET 


34 


MCS DCP ORIENTED COMMUNICATE 


98 


: PUT 
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OBJECT 



Thts parameter Is held In byte one of the CPA. 
Most commonly, It Is an Index Into the task's 
data segment table giving access to data which 
characterizes the entity upon which the function 
Is to be performed. For file type I/O 
comnun I cates , for Instance, It Is the DST Index 
for the associated file Information block. 



ADVERB 



This parameter. If It exists, consists of a 
variable number of bytes starting at byte 2, and 
comprising the remainder of the CPA. 



Refer to figure 8-5 for an example of the History Communicate Table. 

PI DATA 

Refer to figure 8-6 for an example of the PI Data Area. 



PI MAILBOX PAGES 



This structure Is an array of constants which Is 
a list of processor numbers. These are listed 
to be used as labels for the following arrays, 
active input mailboxes, active output mailboxes 
and waiting mailbox Ids. 



PI ACTIVE 
[tPm MAILBOXES 



This array is used by task processors to 
indicate that their output mailbox contains a 
message for the OS. A request Is Indicated by 
an esoe and a response Is Indicated by a i009. 
SFFe is used to denote an idle mailbox. The 
array Is ordered underneath the mailbox pages 
field. 



PI ACTIVE 
OUTPUT MAILBOXES 



This array Indicates the outstanding mailbox 
ACKs. An acknowledgement is Indicated by a 00. 
The processor related to the acknowledgement can 
be found In the equivalent position in the 
active Input array above. Again SFF6 Is used to 
denote the Idle state. 



PI DEAD PRXESSORS 



This field Indicates which processors have gone 
not ready. Each bit represents a bus address (1 
relative). 

NOTE 
This field is byte-reversed. 



PJ WAITING 
MAILBOX IDS 
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This array Indicates actions which are waiting 
for a mailbox acknowledgement. Each byte of 
this array is an action Id (index Into the 
AM_ACTION_LIST). The index Into this table (0 
relative) Is the processor number associated 
with the action. 



HISTORY COMMUNICATE TABLE 



ENTRY 

* *• * t 

13 

II, 

15 

OC 

DD 

Oe 

OF 

10 

11 
^2 



TASK BUS 



ID 
** *« 

OC 
OC 
OC 
OC 
OC 
OC 
OC 
OC 
OC 

nc 



ADDR 
* ««* 
0« 

04 
04 
OA 
04 
04 
04 
04 
04 
04 



VERB 

02 CLOSE 

CLOSE 

TERMINATE 

URITE 

READ 

REAS 

WRITE 

READ 

REA» 

WRITE 



OBJECT 
?2 

2^ 

f 
21 
22 
22 
21 
22 
22 
21 



ADVERB 

101 Or 00 3000000 00000000000000 
1 010 E 003000 00000000000000000 
0000 1 OU 30 OQUOOODQC 0000 000 00 
1C109003000000000COOOOOOOOOO 
00005 B 730000000000 DOOOOO 0000 
00109 rD3O00D00C0OQQDOBOO00O0 
10109 EDSOOODODDOOOOOOOOOOOOO 
0OOC5t7 300000000000000000000 
0010 fUO3DCOOCDO0O0OGD 0000000 
lOIOf D030CuuuDuOOUuOOOUUOUUO 



Figure 8-5. Example of the History Communicate Table Portion of a Dump 



t ***** * 

PI DATA 
******* 



PI WAlieOX PACFS 

PI ACTIVE INPUT MAILBOXES 

PI ACTIVE OUTPUT KAUBOXES 

PI HEAD PROCESSORS 

PI MAITINC MAILBOX ICS 

PI IREE MAILBOXES 

PI OUEUE COUNT 

PI INVOKED 



0102 03U4 050f 0701) OVOA CbOC ODOE 0(F( 

FflF FFFf FFfF IFFE FFFF FFFF FFFF FFFF 

Ffff FFFF FFFF FFFF FFfF FiFF FFFF (FFF 

OOCjO 

FFFF FFFF FFFF FFII FFFF FFFF FFFF FFFF 

FFFF FFFF FFFF FFFF FFFF FFFF FFFf ff 

03 

OD 



Figure 8-6. PI Data Example 



PI DATA (Cont.) 



PI FREE MAILBOXES 



This Is an array of flags Fndfcatlng If the 
mailbox for a processor Is available. (*FF« 
Indicates available.) 
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DA.CT (CONFIGURATION TABLE) 

This table contains one entry per device. This information is used by data access when performing 
opens, OLs and other SCL commands. Each entry of the table contains the following fields: 



ENTRY/PHT INDEX 



This field Is an Index Into the peripheral 
table. 



CMS DEVICE TYPE 



This field contains the device type, such 
as BSM cartridge. The analyzer Interprets 
this field Into both SPO nnnemonic and 
English name. 



TASK ID 



FILE OPEN 



STATUS 



This field Indicates the task Id (Index 
Into the /»1.ACTI0N.LIST). «FFi In this 
field means that no action Is currently 
associated with this entry; It Is only 
valid during Job load, when It contains 
task Id of Job being loaded. 

This field contains the number of files 
open on the device. 

This field Indicates the logical status of 
the device. This Is a 2-byte field, the 
second of which Is not used. The following 
Is a decode of this field as shown by the 
system dump analyzer. 



MSB 7 - Reserved 

6 - Multifile 

5 - Purged 

4 - Unlabel led 

3 - System 

2 - SV or PC pending 

1 - Assigned 

LSB - Ready 



SPO MNEMON IC 



FILE ID 



This field contains the associated mnemonic 
for this device (DMA, DKB, etc.). 

For a disk device, this field contains the 
<pack Id>. For a line printer. It Is 
<flleld) If a file Is currently open on the 
printer. 



SERIAL NUMBER thru 
LOG UNIT 



These fields contain 
found on the device. 



label information 



Refer to figure 8-7 for an example of a DA_CT entry. 
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DEVICE CONFIGURATION TABLE DA-CT 
********************************** 



ENTRY/PHT INDEX 0000 

CHS DEVICE TYPE CE OK-3/6 MINI 

TASK ID FF 

FILE OPEN 0000 

STATUS «000 MULTI-FILE 

SPP MNEMONIC DI^A 
FILE ID 

ALLOCATION UNIT FF 

PACK TAG/LOG UNIT ?0 

SECTORS/TRACK 3B 

ENTRt/PHT INDEX UOOl 

CMS DEVICE TYPE CE OM-3/6 MINI 

TASK 10 FF 

FILE OPEN 0000 

STATUS 4000 MULTI-FILE 

SPO MNEMONIC 0MB 
FILE ID 

ALLOCATION UNIT FF 

PACK TAG/LOG UNIT ?0 

SECTORS/TRACK 38 

ENTRY/PHT INDEX 0002 

CMS DEVICE TYPE CP DK-CARTRIOGt 

TASK ID FF 

FILE OPEN 0000 

STATUS 4000 nuLlI-flLE 

SPO MNEMONIC OKC 
FILE ID 

SERIAL NUMBER 123456 

ALLOCATION UNIT 01 

PACK TAG/LOG UNIT 20 

SECTORS/TRACK 20 



Figure 8-7, Sample DA_CT Dump File Entry 



WB.LB.HEAD 

This field is a pointer to a linked list of work and link blocks currently allocated. The analyzer decodes 
each entry on the list and breaks out the descriptor address and type, and the size, link, type, address 
and owner of the work or hnk block. 
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FIB 



OWNER 

ID 

FILE STATE 



COMM IN PROGRESS 



FILE TAG INFO 



FILE TAG DIRECTORY 



FILE TAG PACKTAG 



FILE USAGE 



FT ADDRESS PAGE 



FT ADDRESS BUS 



The owner from the WB. LB .HEAD of DA_TASKnn_LlST 
using this FIB. DA_TASK_LIST will Indicate the 
user task. 

Segment number of the FIB. 

The values In this field reflect the open/close 
state of the file as follows: 

iOCi = half closed - new file 

«01t = half closed - old file 

I02i = open - new file 

i03i = open - old file 

804f = being opened 

tOSe = half closed - printer backup file 

A flag Indicating If a communicate Is currently 
In progress using this FIB (Flag = 1 Indicates 
In progress/ 

MSB 7 : Extended file 
6 : Overflow file 

(exists on more than one pack) 
5-0 : (k)nf Iguratlon table offset 

For multiple-pack files, this field contains a 
pointer to the disk file header (DFH); this DFH 
win point to the next pack. 

Pseudo pack tag appended to the original file 
name by pseudo pack Impiementation. 

This Is a bit map. 

MSB 7-5 : value 001 = norma I /shared 
111 = locked 
4 : value 001 = shared 
3 : value 001 = locked 
2-0 : value 001 = normal/shared user 
111 " locked user 

Memory page on which the associated file 
resides. 

Memory address of the associated file table. 



Other fields are considered self-explanatory. Refer to figure 8-8 for an example of the FIB entry. 
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F IB 

OWNER 05 
10 1Z 
FILE STATE 03 OPEN OLD 

conn IN PROGRESS 00 
riLE TAG INFO 84 
FILE TAG DIRECTORY 7500 
FILE TAG PACKTAG 20 
FILE USAGE 2D 
ORGANIZATION 02 SEOUENTIAl 

ACCESS 01 
HTUSE 01 
CMS DEVICE TYPE C3 OK-ANY DISK 

FPB 5ESHENT NUMBER OB 

FPB SIZE 5E0D 

OTHERUSE 03 
LAST COHBUNICATE 82 
RECORDS/BLOCK 0100 

RECORD SIZE B400 

WORK AREA SEGMENT 00 

MORK AREA OFFSET 4605 

WORK AREA LENGTH B400 

MAX WRITTEN 0001 A8 

MAX POSSIBLE 0001 A8 

CURRENT RECORD 0000 81 

CUR REC INVALID 00 

CURRENT BLOCK 0000 80 

SECTORS/BLOCK 0100 

BLOCK COUNT 0000 

BACKUP RECORD BUFfER 0000 00 

MAX NUMBER BUFFERS 01 

NUMBER BUFFERS ALLOCATED 01 

BTTES/euFFER B40Q 

OFFSET WITHIN RECORD 0000 

RECORD WITHIN BLOCK 0000 

DYNAMIC ACCESS 00 

EOF FLAG 00 

OUTPUT ALLOWED FF 

SPARE CHARACTERS 0000 

TRANSLATION NEEDED 00 

MS OPEN 00 

ORG DEVICE 59 

FLAGS 00 

PB FILE NUMBER 39 

BUFFER AHEAD NUMBER FFFF FF 

FILE ID 5359 534C 414E 4755 4147 4520 
PB LP DEVICE TYPE 43 
FT ADDRESS PAGE 0007 
<Eir USAGE 31 f ABBRESS BUS 70A5 

KcV 'IL£ TAG 33" 0021 
KEY FIL? E'J^FER ^330 3034 3700 01Cf 3030 3034 3703 0100 3030 3034 3700 OICI 3030 3"^34 3710 31DJ 
3030 3034 7700 31D3 3030 1034 3703 3104 3C30 3034 3703 0105 3333 T334 3730 31P6 
3030 3034 3S00 01D7 3030 3034 3300 01D? 3030 3C34 3800 0109 3030 5034 3800 010A 
3030 3'^34 3500 01D3 3C30 3034 3B00 010C 3030 3034 3800 0100 3030 3334 3300 310E 
3030 3034 3500 010F 3030 3034 333C 01E0 3030 3034 3900 01E1 3030 3034 3930 01E2 
3C33 3034 3903 01E3 3330 3034 3903 01E4 1337 0057 
J=0ATc5 33 
<EY fILc. TABLE A-,0^?S3 0201 F353 
<Ey FILE TA3LE A0D^£S3 2 02 01 2'>D' 
OU°LICATES ALLO.IED FF 
BEAD STATUS 01 
K£Y OFFSET C003 
NULL <tY FILE 03 
SOUGrt TA3LE IN '■lE^OPY 'f 

PRESENT SECTOR 005C 64 

LAST ACCESS 00 
CLII5=iENT A5£A 1 00 
CURRENT SECTOR 1 OO'-C 64 
CURRENT OFFSET 1 \0 

CUSPENT RPrj 1 3001 E3 
CJ'-!ENT APEA 2 CO 
CURRENT SECTOR 2 005C 6' 
CURRENT OFFSET 2 Co 

CUR'E\T i"N 2 3000 03 

CURRENT KEY 33''0 3034 39FF FFFF FFFF FFFF FFFf FFFF FFFF FFFF FFfF FFFF FFFF FFFF FFFF FFFF 
FFFf FFFF FFFF FFFF FFFF FFFF FffF FFFF FFFF FFFF FFFf FFFF 
ENTRY SIZE 35 
ROUGH TA3LE SHE 0300 32 

AREA «4UM = ER SECTOR OFFSET KEY ENTRY 

**♦* ♦****+ ****** ****** *** ***** 

"0 0300 3030303530 

00 0000 FFFFFFFFFf 

Figure 8-8. File Information Blocli Example 
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ODT DATA SEGMENT 

The fields of this portion of the formatted dump file are explained in the following list. A sample 
of this section is shown in figure 8-9. 

SYSCONFIG Twenty bytes which contain ZIP text taken from the 

ZIP TEXT SYSCONFIG file. 

REMOTE TASK One byte which contains the task ID of the progran logged 
ID on as renote SPO. 

CONTROLLING Not used. 
SPO ID 

CONTROLLING Not used. 
SPO TAG 

SPO ACTIVE This Is a 2-byte field; each bit Indicates If the 
ARRAY associated task Is a REMOTE SPO operation. 

ODT FLAGS This Is a 1-byte field. The significance of Its bits 

Is as fol lows: 

Bit 7 (MSB) ODT In shutdown mode 

Bit 6 Remote SPO Is allowed 

Bit 5 Processing PO message 

Bit 4 01 routine In shutdown 

Bits 2 & 3 Not used 

Bit 1 A remote SPO exists 

Bit Local SPO In use 

ACTIVITY This Is a one-byte field. The significance of each bit 

FLAGS Is as fol lows: 

Bit 7 (MSB) 01 START complete 

Bit 6 01 SYSMESSAGE down 

Bit 5 Not used 

Bits 3 & 4 00 - No local SPO exists 

01 - Local SPO exists 

Bit 2 SYSIO buffer WB exists 

Bit 1 Dictionary Is open by 01 

Bit SYSC0^FIG Is open by 01 



DICTIONARY 
FIB ID 



This Is the FIB ID of the dictionary file. 



SYSIO WB ID This Is the ID of the work block being used for SYSIO. 



ROUTING 


LIST HEAD 


ROUTING 


LIST TAIL 


SPO QUEUE 


HEAD 



This is the ID of the link block entry at the head of 
the routing II st. 

This Is the ID of the link block entry at the tall of the 
routing list. 

This Is the ID of the link block entry at the head of 
the SPO queue. This Is a holding area for messages. 
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AOT DATA SEGMENT 



£V3C0NFIG ZIP TEXI FFFF 

DEHOTE TAaK lU FF 

CONTROLLING oPO ID FF 

CONTROLLlMfi SPO TAG FF 

i>PU ACTIVE ARRAY OilOO 

ODT FLAGa HI 



ACTIVITY FLAGa dA 



FFFF FFFF FFfF FFFF FFFF FFFF FFFF FFFF FFFF 



HENOTE SfO ALLOVEQ 
LOCAL SPO IN USE 



OICIIONAiiV FIB to 

SfSlO KB 10 

ROUtlMG LIST liEAO 

ADUIflNG LIST TAIL 

OOT List HEAil 

OOT List TAIL 

SPO UUEUE HEAD 

SCL QUEUES HEADS 

arO QUEUE TAIL 

JCL QUEUES TAILS 

ROUTING POST ID 

OOT POST ID 

SPO CHANNEL ID 

LUNG nSS INDEX 

ADDRESS UF HSG OUT 

nSS OUT DATA 

nsG IN 



CONSOLIDATED STATUS 



TiiANSHIT STATUS' 

RECEIVE KIATJa 

DCl FLAGS 

PROC FLAGS 

RECEIVE CHAM 

OCI iHANSniT lu 

CHARACTER COUNT 

TIHER VALUE 

HESSAGE TYPE 

nsG OUT LENGTH 

nSG OUT INDEX 

NS6 IN INDEX 

nSG IN LENGTH 

rise IN yB ID 

SEND PROGRESS 

TERKINAL SEQUENCE 

HEADER SEQUENCE 

LINEFEED SEQUENCE 

ERROR SEQUENCE 

CLEAR 1 SCROLL 



I3^00 
01 

5>3 
^B 

yu 

98 
•jn 

OdOO 

Otl 

UOOO 

16 

FF 

|I3 

0700 

55C5 

iiooa 

1130 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



HO 
liO 

do 
15 

1» 

dO 

Od07 

00 

ICOO 

0700 

0300 

1000 

FF 

Ou 

iHli 

OlHl 



01 START COMPLETE 
LUCAL SPU EXISTS 
DICTIONARY IS OPEN BY 01 



0000 0000 OOdO UOOO 0000 OOOd OOdO 0000 UOOO 0000 
OOOd OOdO 0000 OOOO dOOd OOdO OdOO 0000 dOOO OOdO 



OOOd 
OZXH 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FF 



OOdO 
5320 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



0000 
3033 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



OdOO 
2F<l<t' 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



0000 
554D 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



OOdO 
HD59 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



0000 
2E32 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



0000 
3130 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



UOOO 
3403 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



OOdO 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



OdOO 
0000 



OdUO 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



gUOO 0000 OOOd 0000 
0000 0000 0000 OUOO 



dUOO 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



OOOD 

FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



FFF 
FFF 
FFF 
FFF 
FFF 
FFF 
FFF 
FFF 



liECEIVE REQUEST 



IHANaHir UNOERVAY 



0301 
3002 



1822 202H IBHD 1822 2037 202U 20 

OlHl 3002 1B22 2F23 ld4B 1B22 «B23 3C45 5252 3E 

0141 3002 1B22 3d20 IBtB 1B22 2021 IBHB 1B22 2022 IB H«l ld22 2023 1B4B 1622 2023 

1B53 1B4S 1B53 1B4B 1853 IBHB 1853 18HB 



Figure 8-9. Sample ODT Data Segment 
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SPO QUEUE This Is the ID of the link block entry at the tall of 
JAIL the SPO queue. 



SCL QUEUES 
TAILS 

ROUTING 
POST ID 

ODT POST 
ID 

SPO CHANNEL 
ID 

LONG MSG 
INDEX 

ADDRESS CF 
MESSAGE OUT 



Not used. 



This Is the ID of the status block that is handling 
message rout I ng. 

This Is the ID of the status block that Is handling ODT 
output messages. It is used by the routing action. 

This Is the physical channel for the ODT device. 



This Is the Index Into output messages that are longer 
than one screen. 

This is a 2-byte address of the message being sent 
to the ODT. 



MSG IN Input message from the ODT. 

CONSOLIDATED This Is a 1-byte field. The significance of the bits 

STATUS is: 

Bit 7 (MSB) Transmit request 

Bit 6 P,ecs1ve request 

Bit 5 Timer A request 

Bit 4 Timer B request 

Bit 1,2,3 Not used 

Bit Receive error 

ODT DC I status for Transmit state. 



TRANSMIT 
STATUS 

RECEIVE 
STATUS 

DC I FLAGS 



ODT DC I hard status for Receive state. 

This Is a 1-byte field. The significance of the bits 
Is: 

Bit 7 (MSB) DCI is finished 
Bits 4,5,6 Not used 
Bit 3 Transmit Inside receive 

Bit 2 Transmit desired 

Bit 1 Transmit underway 

Bit Receive underway 

PROC FLAGS This Is a 1-byte field. The significance of the bits 

is: 

Bit 7 (MSB) An error was logged 

Bits 5,6 Not used 

Bit 4 Explicit line feed 

Bits 1,2,3 Not used 

Bit Error In message 
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RECEIVE 
CHAR 



This !s the last chareicter received from the ODT. 



DCI This Is the ID of the status block that Is handling DOT 

TRANSMIT output messges. This Information Is used by ODT DCI 

ID Interrupt action. 

CH^RACTER This Is the count of the number of characters received 

COUNT from the ODT. 

TIMER VALUE This Is a value used to prime a hard timer In the ODT 
DCI. 

MESSAGE This Is a value used to Indicate various Internal 

TYPE message types; for example system messages or ODT 



MSG oirr 

Length 



This Is the length of the ODT output message In bytes. 



MSG OUT 
INDEX 



Index to the current character being output to the OOT. 



MSG IN 
INDEX 



Index to the current character being Input from the OOT. 



MSG IN 
Length 



This Is the length of the OOT message In bytes. 



MSG IN WB This Is the ID of the work block where the Incoming ODT 

ID message Is being placed. 

SEND This Is an Internal value used to step through the 

PROGRESS transmission sequence. 



TERMINAL 
SEQUENCE 

HEADER 
SEQUENCE 

LINEFEED 
SEQUENCE 

ERROR 
SEQUENCE 

CLEAR & 
SCROLL 



Each of these sequences Is a series of control characters 
used by the ODT control ler to manipulate the ODT screen 
under various circumstances. 
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SECTION 9 
DATA COMMUNICATIONS 
INTRODUCTION 

The data communications portion of a system dump is divided into three sections. Each section repre- 
sents oneiaf the major parts of the B 900/CP 9500 Data Comm (DC) Subsystem. These sections are: 

DCA MEMORY (Data Comm Activity Memory) 

DCP MEMORY (Data Comm Processor Memory) 

BUFFER MEMORY 

This section examines these three parts in detail. They are discussed in the order in which they appear 
in a printed dump file. 

DCA MEMORY 

DCA memory is part of OS MEMORY and is maintained by the MCP. This area is divided into two 
subsections. Both subsections reside in OS MEMORY but they are managed differently. 

The first and most important area of DCA MEMORY is the resident data segment. This segment of 
memory forms the nucleus of the DC subsystem. It maintains an address directory for tables located 
in Buffer Memory (BM) and Virtual Memory (VM), and for various other size values and fields neces- 
sary to maintain the DC subsystem. 

The second area of DCA MEMORY is part of VM, and contains the tables responsible for driving 
the DC subsystem. The information in these tables is extracted from the NDLSYS file at the time the 
Message Control System is loaded. 

RESIDENT DCA MEMORY 

A list and description of the DCA MEMORY fields resident in OS MEMORY follows. These items 
are discussed in the order in which they appear in the printed dump. The contents of the 2-byte fields 
are printed in byte-reversed order. 



NOTE 
In reading a printed dump, it is very important to understand the limits and 
basic operation of Virtual Memory. Table 9-1 gives the Data Comm tables 
which are maintained in VM. At the time a dump is taken, the contents of 
these tables may be in memory or they may be "swapped out" and located 
in disk memory (referred to as backing store). Any table or field may yield 
its space to another user. The VM algorithm determines which tables and 
fields are swapped out. If a table or field is in backing store when a dump 
is taken, the dump gives the address in resident memory at which it was last 
located. It is particularly important to keep this concept in mind if a Hex 
dump becomes necessary. 
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Table 9-1. DC Subsystem Table in Virtual Memory 



USER JOB table 


ID = 1 


MCS table 


ID = 2 


LSNTAB table 


ID = 3 


LLNTAB table 


ID = 4 


SUBTAB table 


ID = 5 


NDL table 


ID = 6 


DCP tab le 


ID = 7 


XPCON table 


ID = 8 


LSN INFO table 


ID = 9 


MCS NAIC table 


ID = A 



RESERVED 



This 1-byte field Is reserved for special use. 
At the present time, this field Is set to 1 If a 
DC.RECONFIG has been used since the loading of 
the DC subsystem. 



MCS LOADED 



Binary count of the number of Message Control 
Systems (MCSs) physically loaded. 



DCP LIMIT 



This 2-byte field contains the 
DCP number (defined in NDL). 



highest logical 



BUFFER SIZE 



This 2-byte field Is the size (In bytes) of the 

Data Ccmm Buffer as determined In the DCP 

SECTION of the NDL. It Is Incremented by 4 when 
the WTA COMM LOAD ACTION is performed. 



STATION COUNT 



This 1-byte field contains the total number of 
stations defined In the NDL. Both real and 
dummy stations are Included In this count. 



USER DC LOGS 
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This Is a 4-byte field brd^en out In the dump 
listing as two 2-byte fields, USER DC LOGl and 
USER DC L0G2. Together these two fields make up 
a 32-bIt field, each bit representing one of the 
32 possible (maximum) TASK IDs (user jobs). 

NOTE 
Only 26 Jobs are supported by the 3.04 MCP. 



When a user Job is executed and goes to BOJ, the 

appropriate bit Is set; the bit Is reset when 

the Job ends (DS, DP, or EOJ). The format for 
these fields is as follows: 



USER rc L0G1 



USER DC L0G2 



Byte 1 (bits 7-0) 
Byte 2 (bits 15-8) 
Byte 3 (bits 23-16) 
Byte 4 (bits 31-24) 



SUBNt I COUNT 



This 1-byte field contains the total number of 
subnet queues which are defined in the FILE 
SECTION of the NDL. 



LINE COUNT 



This 1-byte field contains the total 
lines which are defined in the NDL. 



number of 



DC EOJ ACTION ID 



This' 1-byto field Is initialized to «FF« 
when the DC.LOAD.ACTION.IO Is performed during 
the loading of the DC subsystem. This field 
holds the ACTION. ID If and when the DC.EOJ 
action is suspended. Suspension of the DC.EOJ 
action occurs when the last MCS Is terminating 
and any one of the COBOL ACTIVE flags of the 
User Job Table Is set. 



LFN BLOCK SIZE 



A 2-byte field containing the size of the link 
blocks used to hold the list of logical file 
names. The list of logical file names can be 
found In the Work Block/Link Block list In the 
Operating System section of the dump. 



LSN BLOCK SIZE A 2-byte field containing the size of the link 

blocks used to hold the list of Logical Station 
Names. The list of Logical Station Names can be 
found In the Work Block/Link Block list In the 
Operating System section of the dump. 



XLSN BLXK SIZE 



A 2-byte field containing the size of the link 
blocks used to hold the list of Extended Station 
tables.. The Extended Station tables can be found 
In the Work Block/Link Block list In the 
Operating System section of the dump, action ID 
stored In this field Is used to reinstate the 
Job. 



USER JOB LAST ADDRESS 



This 2-byte field Is the OS MEMORY ADDRESS at 
which the User Job Table was last located. The 
contents of the User Job Table are described 
later in this section. If It becomes necessary 
to check the Hex dump, remember that this table 
may have been swapped out, and this address may 
be invalid. (LIM<ED BLXK ID = 1) 
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TASK TO MIX TABLE 



This ts a 32-byte array (one per allowable task 
nurtber) that can be used to find a Job's 
external mix number when Its TASK- ID Is known. 
The Job's task number Is used as a 0-relatlve 
Index Into the array In order to obtain the mix 
number. This table Is Initialized to all Os- 



MCS ID TABLE 



This 32-byte array (one byte for each allowable 
task number) can be used to find a task's 
relative MCS number when its task number Is 
known. The MCS task number Is used as a 0- 
relatlve Index Into the array to obtain the 
relative MCS number. This table Is Initialized 
to at I SFFSs. 



MCS TABLE 
LAST ADDRESS 



This 2-byte field Is the OS MEMORY ADCRESS at 
which the MCS table was last located. The 
contents of this table are described later In 
this section. If it beccmes necessary to check 
the Hex dump. It should be ranembered that this 
table Is stored In Virtual Memory and, 
consequently, the Hex address may not be valid. 
(LINKED BLXK ID = 2) 



LSN CONVERSION 
LAST WDRESS 



This 2-byte field is the OS ^'EMORY ADCRESS at 
which the LSN conversion table (LSNTA8) was last 
located. The contents of LSNTAB are described 
later In this section. (LINKED BLXK ID = 3) 



LSN IKFO 
LAST ADDRESS 



This 2-byte field Is the OS MEMORY ADDRESS at 
which the LSN INFO table was last located. The 
contents of this table are described later In 
this section. (LINKED BLOCK ID = 9) 



LINE CONVERSION 
UST ADCRESS 



This 2-byte field Is the OS MEMORY ADDRESS at 
which the Logical Line (LLN) Conversion Table 
was last located. The contents of this table 
are described later In this section. (LINKED 
BLOCK I D = 4 ) 



SUBNET INFO 
UST ADDRESS 



This 2-byte field Is the OS MEMORY ADDRESS at 
which the SUBNET INFO table was last located. 
The contents of this table are described later 
In this section. (LINKED BLOCK ID = 5) 



OOP CONVERSION 
UST ADCRESS 



This 2-byte field shows the last address for the 
OCPCON Table. (LINKED BLOCK ID =« 8) 



DCP TABLE 
LAST ADCRESS 



This 2-byte field shows the last address for the 
DCP Table. The contents of the DCP Table are 
described later In this section. (LIhKED BLOCK 
ID = 7) 
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NDL QMA 

I AST AnnpFSS 



This 2-byte field gives the last OS MEMORY 



I ne conrenTs or xne 



Ar^r 

NDL Table are described later In this section. 
(LINKED BLXK ID = 6) 



MCS N^^€ 
LAST ADDRESS 



This 2-byte field gives the last OS MEMORY 
ADDRESS at which the MCS NAME table was last 
located. The contents of this table are 
discussed later in this section. (LIM<ED BLOCK 
ID " A) 



ASP ADDRESS 



This 4-byte field Is the offset, page, and bus 
address of Information about the Available 
Buffer Pool. The first t>*o bytes of this field 
contain the offset, the third byte Is +ho page 
number, and the last byte Is an address pointing 
to where buffer pool Information Is stored. 
This second location has a 1 2-byte field divided 
Into f I ve groups: 



Read With Lock Word (RLW) I byte: 00 = unlocked 

01 » locked 

1 byte 

2 bytes 

4 bytes: page, bus, address 
4 bytes: page, bus, address 



Processor ID 
Buffer Count 
ABP Head Pointer 
ABP Tail Pointer 



The APB TAIL POINTER field Is printed by the 
dump at the beginning of the ABP area in the 
BUFFER section. 



REQUEST ADDRESS 



This 4-byte field gives three pieces of 
Information. The first two bytes contain the 
offset, the next byte Is the page number, and 
the last byte gives the beginning address where 
Information describing the first REQUEST Q is 
stored. The Information available is: 



SUBNET Q ADDRESS 



Read With Lock Word (RLW) 1 byte: 00 = unlocked 

FF = locked 
4 bytes: page, bus, address 
4 bytes: page, bus, address 



Request Q Head Address 
Request Q Tail Address 



There can be up to nine request queues (one for 
each DCP) numbered through 8. Request queues 
are printed by the dump In the BUFFER section. 

This 4-byte field is divided into three 
sections! first two bytes contain the offset, 
the ne«t byte is the page number, and the last 
byte is the beginning address at which 
Information describing the first subnet queue Is 
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stored. There Is one subnet queue for each file 
defined In the NOLSYS file. The Information is 
supplied In 10 bytes, divided Into four fields: 



Queue Limit 

Queue Count 

Subnet Q Head Address 

Subnet Q Ta 1 1 Address 



1 byte 

1 byte 

4 bytes: page, bus, address 

4 bytes: page, bus, address 



The subnet queues are printed In the dump and 
are located In the BUFFER section. 



RESULT QUEUE ADCRESS 



This 4-byte field contains the offset In the 
first two bytes, the page number In the next 
byte, and the last byte contains the bus address 
where Information describing the result queue Is 
stored. There Is only one result queue In a 
data comm subsystem. It Is used to return 
Information to the OS processor. 



Ten bytes describe the result queue: 



Read With Locl^ word 



IX BUF fCM ADDRESS 



1 byte: 00 = locked 

FF = un I ocked 
1 byte 



Processor ID 

Result Q Head Address 

Result Tall Address 4 bytes: page, bus, address 

The result queue is printed by the dump In the 
BUFFER section. 

This 4-byte field Is the page, bus, and offset 
In buffer memory where the data conrn buffers 
begin. 



RESERVED 

LINE INFO SIZE 



These four bytes are currently unused. 

This 2-byte field Is the size of each line Info 
area. Each line Info area Immediately precedes 
Its respective line table In DCP memory, and 
contains the additional line Information needed 
by the OCR. (For a description of line 
Information area fields, see DCP Memory 
Section.) 



PHYSICAL DCP LIMIT 



DC LIST ID 



This 2-byte field contains the highest physical 
DCP number attached to the system. 

This 1-byte field contains the value used to 
Identify the elements in the data comm linked 
block list In OS Memory, and Is used when any 
data ccmm linked blocks are accessed. 
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VIRTUAL DCA MEMORY 

This is the second part of the DCA Memory area. Descriptions of the tables and fields within Virtual 
Memory follow. The items are given in the order in which they appear in the printed dump. 

USER JOB TABLE (LINKED BLOCK ID = 1) 

This table has an entry for each job declared in the mix. For each job, the following fields of informa- 
tion are printed in the dump listing: 



OUTPUT LIMIT/COUNT 



This array contains 32 entries, one for each 
al lowabte task number. Each entry consists of 
two bytes: The leftmost byte Is the current 
value of the task's output limit; the rightmost 
byte Is the current value of the task's output 
cmint. These values are Initialized to i02i and 
8008, respectively, for each user Job by the NDL 
coqjpller. The user Job's task ID Is used as an 
Index Into this array. 



COBOL ACTIVE FLAGS 



This 4-byte field consists of 32 bits, one for 
each allowable task number. Each time a user 
Job Is actively executing VERB33, a bit Is set 
for that Job's task number. This flag will 
prevent the last MCS from going to EOJ and 
terminating the whole DC subsystem while VERB33 
Is active for a task. DC.EOJ suspends Itself If 
any of these bits are set. 

The layout of the 32 bits In menory Is as 
f o 1 1 ows : 



WAITING QUEUE 



7 


15 


8 23 


16 31 


24 


[ 


1 I 


1 [ 


1 ( 


] 



Bits 



Byte Byte 1 Byte 2 Byte 3 

This array contains an entry for each allowable 
task number. Each entry contains the queue 
reference that the task Is waiting on, or 8FFFF8 
If the task Is not waiting on a queue. The 
Job's task number Is used to Index this array. 



UST COW 



This 32-byte array contains an entry for each 
al lowable task number. Each entry contains the 
active ADVERB of every VERB33 action being 
performed. At the end of the VERB33 action, the 
entry Is restored to 8FF8. The Job's task ID Is 
used to Index this array. 



IPC ORIGIN STATION 
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This array contains 32 2-byte entries, one for 
each al lowable task number. This array Is used 
by the IPC canmunlcate to save the LSN of the 
sending IPC program. The LSN can be cross- 
referenced by using the LSN INFO Table. The 
Job's task ID Is used to Index this array. 
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UST QUEUE 



This 32-by+e array contains an entry for each 
allowable task number, and Is used with the 
Complex Walt function of MPLII and CC80L. The 
queue Identity number for which the Job has been 
suspended Is stored In this field. This field 
works with a round-robin event scanner, looking 
for al I or any one of the subnet queues which 
were specified In the Complex Walt statement. 
The Job's task ID Is used to Index this array. 



MCS TABLE (LINKED BLOCK ID = 2) 

This table contains an entry for each MCS declared in the mix. 
of information are printed in the dump listing: 



For each MCS, the following fields 



MCS 



This Is the relative MCS number. This value Is 
not stored In the table, but rather. Is used as 
an Index Into the table. 



mK 



This 1-byte field is the ID of the linked block 
that contains the MCS message reference area. 
It can be used as an Index Into the linked block 
1 1 st to reference the MRA. 



QUEUE HEAD 



This 4-byte field Is the bus, page, and offset 
address of the head of the MCS aueue. 



QUEUE TAIL 



This 4-byte field Is the bus, page, and offset 
address of the tall of the MCS queue. 



QUEUE COUNT 



This 2-byte field contains the current number of 
messages on the MCS queue. 



TASK ID 



This 1-byte field holds the MCS's internal task 
number. 



Mse RtF 



ihls 1-byte tieid is the size oT rne wa i i nK 
block defined In the MCS source program. The 
value In this field reflects the size of the 
Message Reference Area (MRA) as it was defined 
In the MPLII MCS program. Refer to sections 10 
and 12 of the MPLII Reference Manual, form 
2007363, for additional Information. 



LSNTAB (LINKED BLOCK ID = 3) 

This is the logical station conversion table. This table contains an entry for each station defined in 
NDL. For each station the following fields of information are printed in the dump listing: 



LSN 



The logical station number as defined in NDL. 
This Is used as the Index when using the LSNTAB. 



PROCESSOR 



This 2-byte field holds the number of the 
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phystcal DCP to which this station Is attached. 
If this field contains «FFFEe, the DCP Is 
unloaded due to an error condition In the 
processor. If this field contains SFFFFi, the 
station was not declared to be attached to a 
line In the NDL, or was detached by a 
R03EFINE.STATION communicate. 

STATION TABLE ADDRESS This 2-byte field contains the address of the 
Station Table In DCP MEMORY. Refer to the 
Processor field to determine which XP Memory to 
reference In the dump. 



DISK TABLE SIZE 



This 1-byte field contains the size (In bytes) 
of the Station Table on disk for this station. 



ORIGINAL OWNER 



This 1-byte field contains the relative MCS 
number of the MCS that was assigned to this 
station In the NDL file. If no MCS was assigned 
In NDL, this field Is Initialized to iFFS, and 
will later be assigned the relative MCS number 
of the first MCS to access this station. If 
this Is a sIngle-MCS system, then this field Is 
Initialized to 6006. 



CURRENT OWNER 



This 1-byte field contains the relative MCS 
number of the MCS that currently owns this 
station. It Is Initialized to the value of the 
original owner. 



LLN 



This 1-byte field contains the logical line 
number of the line that this station Is 
currently attached to. If the station Is not 
currently attached to a line, this field 
contains fiFFS. 



LLNTAB (LINKED BLOCK ID = 4) 

This is the logical line conversion table. This table contains an entry for each line defined in NDL. 
For each hne the following fields of information is printed in the dump: 



LLN 



This is the logical line number as defined In 
NDL. This value is used as the index Into the 
LLNTAB. 



PROCESSOR 



This 2-byte field contains the physical DCP 
nunfcer to which this line Is attached. If this 
field contains tFFFEi, the DCP has become 
unloaded due to an error condition in the 
processor. 



LINE TABLE ADDRESS 
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This 2-byte field contains the address where the 
Line Table is found in DCP Memory. Refer to the 
PROCESSOR field to determine which DCP to 
reference In the dump. 
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DISK TABLE SIZE 



RECOIL I G F=tNDING 



This 2-byte field contains the size (In bytes) 
of the Line Table on disk for this line. 

This 1-byte field Is a flag used to prevent txo 
MCSs from simultaneously redefining the same 
line, or fron executing RELOAD while 
RECONFIGURATION or another RELOAD Is executing. 
This flag Is set to «FF« If a REDEFINE or RELOAD 
Is executing for this line; otherwise. It Is set 
to 6006. 



SUBTAB (LINKED BLOCK ID = 5) 

This table contains an entry for each subnet declared in NDL. For each subnet, the following fields 
of information are listed: 



SUBNET 



The relative subnet number as declared In NDL. 
This Is used as the Index Into the Subnet Table. 



ORIGINAL OWNER 



This 1-byte field contains the relative MCS 
number of the MCS that was assigned to this 
subnet In the NDL file. If no MCS was assigned 
In the NDL, this field Is Initialized to 6FF6, 
and later will be assigned the relative MCS 
number by the first MCS to access this subnet. 
If this Is a system subnet, this field Is 
Initial Ized to 6006. 



CURRENT OWNER 



This field contains the relative MCS number of 
the MCS that currently owns this subnet. It Is 
Initialized to this value by the original owner. 



ATTACHED 
MIX TABLE INDEX 



This 4-byte field contains 32 bits, one for each 
allowable task number. A bit Is set for each 
user job that Is currently attached to this 
subnet. Task numbers range from to 31 and are 
printed here as a set of 32 decimal digits. 



NDL (LINKED BLOCK ID = 6) 

This table contains information that points to the various structures and data within the NDLSYS file. 

MODEM COUNT This 1-byte field contains the number of modems 

defined In the NDL. 

TERMINAL COUNT This 1-byte field contains the number of 

terminals defined In the NDL. 



STATION TABLE SIZE 



This 1-byte field contains the size of each of 
the Station Tables In the NDLSYS file. 
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NDLSYS FIB ID 



This 2-byte field contains the ID of the system 
FIB for the NDLSYS file. 



RECON FIB 



This 2-byte field contains the ID of the system 
FIB for the RECON file. 



LINE TABLE 
ADDRESS 



This 2-byte field contains the disk file record 
number IntheNDLSYS file at which the Line 
Tables begin. Line Tables are on disk In LLN 
order. Full details of the format of the NDLSYS 
file will be found In the Data Comm Subsystem 
Reference Manua I ( form 1 090909) . 



LINE DISP ADDRESS 



This 2-byte field contains the disk file record 
number In the NDLSYS file of the Line 
Displacement Table. This table contains a 2- 
byte pointer to each Line Table. Index Into 
this table Is by LLN. 



STATION TABLE ADDRESS This 2-byte field contains the disk file record 
number in the NDLSYS file at which the Station 
Tables begin. Station Tables are on disk In 
order of LSN. 



STATION DISP ADDRESS 



MODEM TABLE ADDRESS 



MODEM TABLE LENGTH 



This 2-byte field contains the disk file record 
number In the NDLSYS file at which the Station 
Displacement list begins. This table contains a 
2-byte pointer to each Station Table. Index 
into this table Is by LSN. 

This 2-byte field contains the disk file record 
number In the NDLSYS file at which the Modem 
Tables begin. 

This 2-byte field contains the length In bytes 
of the Modem Tables disk area. 



TERM TABLE ADDRESS 



This 2-byte field contains the disk file record 
number In the NDLSYS file at which the Terminal 
Tab ies begl n. 



TERM TABLE LENGTH 



This 2-byte field Is the total length (In bytes) 
of the Terminal Table on disk. 



FILE TABLE ADDRESS 



This 2-byte field contains the disk file record 
number in the NDLSYS file at which the File 
(subnet) Tables begin. 



EX-STATION TABLE 
ADDRESS 



This 2-byte field contains the disk file record 
number In the NDLSYS file at which the Extended 
Station tables begin. 



EX-STATION TABLE 
LENGTH 



This 2-byte field contains the total length (In 
bytes) of the Extended Station Tables disk area. 
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EX-TEW TABLE ADDRESS 



This 2-byte field contains the disk file record 
number in the NDLSYS file at which the Extended 
Terminal Tables begin. 
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EX-TERM TABLE LENGTH 



This 2-byte field contains the total length (In 
bytes) of the Extended Terminal Tables disk 
area. 



STATION tWE TABLE 
DISK ADDRESS 



This 2-byte field contains the disk file record 
number In the NDLSYS file at which the station 
name table begins. The names are arranged 
alphabetically within the table and each entry 
Is 12 bytes long, space fll led on the right. 



STATION NAME TABLE 
LENGTH 



This 2-byte field contains the total length (In 
bytes) of the station name tables disk area. 



FILE NWE TABLE 
ADDRESS 



This 2-byte field contains the disk file record 
number In the NDLSYS file at which the File Name 
Table begins. The file (subnet) names are 
arranged alphabetical ly within the table, and 
each entry Is 12 bytes long, space filled on the 
right. 



FILE N^^C TABLE 
LENGTH 

DCP TERMINALS ADDRESS 



DCP TERMINALS LENGTH 



This 2-byte field Is the total length (In bytes) 
of the File (Subnet) Name Table on disk. 

This 2-byte field contains the disk file record 
number In the NDLSYS file at which the DCP 
Terminals (FORMAT B) segment begins. This 
segment contains Information concerning the DCP 
code files and their associated terminals. 

This 2-byte field contains the total length (In 
bytes) of the DCP Terminals (FORMAT B) disk 
Information. 



DCP (LINKED BLOCK !D = 7) 

This table contains an entry for each DCP declared in NDL. For each DCP, the following fields of 
information are displayed: 



DCP 



FILENAME 



PHYSIC/>L DCP NUMBER 



The logical DCP number. This Is used as the 
Index Into the DCP table. 

This 2-byte field contains the name of the 
codeflle that Is currently loaded Into this DCP. 

This 2-byte field contains the physical DCP 
number associated with this logical DCP. If the 
DCP was never loaded or Is frozen, this field 
contains SFFFFS. 
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DCPCON (LINKED BLOCK ID = 8) 

The DCP Conversion Table is an 8-byte array (one byte for each allowable DCP) that can be used 
to find a DCP's logical DCP number when its physical DCP number (bus address) is known. 

The physical DCP number is used as an index into the array to obtain the logical DCP number. 

LSN INFO (LINKED BLOCK ID = 9) 

This table contains additional information for each station declared in the NDL. For each station, the 
following fields of information are displayed: 



LSN 



The logical station number as defined In NDL. 
This Is used as an Index Into the LSN INFO 
table. 



OUrPUT QUEUE 



This 1-byte field contains the output routing 
for this station. A value of 8FFf Indicates 
that output to this station wl I I be routed to 
the MCS queue (MCS participating). A value of 
iOOe Indicates that output for this station Is 
routed directly to the station queue (MCS non- 
part Id pating). A value of flFES Indicates that 
output to this station will be routed to the IPC 
subnet queue. 



OUTPUT SUB (J 



This 1-byte field contains the valid subnet 
queue number for this dummy station. This field 
Is used to support the IPC Interface. 



IhPUr QUEUE 



ATTACHED MIX TABLE 
INDEX 



This 1-byte field contains the subnet number of 
the subnet queue that this station's Input will 
be routed to. SFFS Indicates that this 
station's input will be routed to the MCS queue 
(MCS participating). 

This 4-byte field contains 32 bits, one for each 
allowable task ID. A bit Is set for each user 
Job that is currently attached to this station. 
Task numbers range from to 31, and the field 
Is printed as a string of 32 decimal numbers. 



MCSNAME (LINKED BLOCK ID = A) 

This table contains the number of MCSs defined in the NDL, and the name of each MCS. This infor- 
mation is displayed as follows: 



MCS 



This Is the relative MCS number. It is used by 
the system as an index into the MCS Name list. 



PACK ID 



This 7-byte field contains the Pack ID specified 
in NDL for this MCS. 



1118478 



9-13 



FILEN/yC 
MCS-COUNT 



Thts 12-by+e field contains the MCS File ID. 

This 1-byte field contains the number of MCSs 
defined In NDL. For sIngle-MCS systems, this 
field contains flFFfi. 



DCP MEMORY 

The second part of the Data Comm Section is DCP Memory. The DCP memory contains the micro- 
code generated by the NCP900 or NCP900P program, the global data area, and the line- and station- 
related information. These data areas are divided into two subsections, the first being the Reserved 
Pointer Area, and the second being the Line Information Area. If the DC subsystem has more than 
one DCP, the lowest bus address is dumped first, followed by the next higher DCP bus address. 

RESERVED POINTER AREA 

This area contains all of the address and stack pointers necessary to maintain this DCP. In addition, 
this area contains the global data area,- and holds information pertaining to PI, line and station sizes, 
processor registers, SAVE state, and processor status information. In short, the majority of key DCP 
information is contained in this area. This information is displayed as follows: 



DCP ADDRESS 



This Is the bus address of 
determined by the Analyzer. 



this DCP and Is 



ERRORFORCE, 

I NTERRUPTFORCE, 

CLEARFORCE 

OS PROCESSOR ID 



These three 

when forced through low menory by the processor = 



This two-byte field Is the bus address of the OS 
Processor. It Is not byte-reversed. 



1^PUT MAILBOX (1MB) 
1MB REQUEST FUNCTION 
1MB REQUEST PRXESSOR 
1MB RESULT PROCESSOR 
1MB RESULT FUNCTION 
1MB SYSTEM MIX NUMBER 
1MB AWAITING MAILBOX 
1MB FLAGS 

OUTPUT MAI LBOX (OMB) 
CMB REQUEST FUNCTION 
OMB REQUEST PROCESSOR 
OMB RESULT PROCESSOR 
OMB RESULT FUNCTION 
OMB SYSTEM MIX NUMBER 
OMB AWAITING MAILBOX 
CMB FLAGS 

MY MAI LBOX FLAG 
NM FLAG 



These fields are the standard 
PI fields. Layout and content 
of mailboxes Is covered In 
Section 10. The only values 
that are used by the DCP for 
request function are S7CS 
(dummy poll response) and 8086 
(DCP waking up DCA to look at 
result queue). 



DCP ID 



This field Is Inltallzed by the Data Comm Loader 
and should be the Processor ID of this DCP. 
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NDLSYS DATE STAMP, 
RANDOM NUMBER 



These two fields are used to check that the NPC 
microcode file and the NDLSYS file are a matched 
pair. During NPC900, the random number Is 
Inserted Into both NDLSYS and the microcode 
flle(s) that Is (are) being generated. 



LINE INFO AREA SIZE 



This field contains the size 
LINE I^FO area. 



In bytes of the 



PRI LINE INFO 
AREA SIZE 



This 1-byte field Is the size of the extra area 
needed for multl-MCS control Information. These 
fields are present In the primary LINE t^FO area 
only. 



DCP END ADDRESS 



This Is the address In DCP Memory of the end of 



DCP TABLES 
BEGIN ADDRESS 



DCP tables are loaded at the top of DCP Memory. 
This address points to the bottom of the table 
area. (This should be greater than DCP end 
address.) 



BUFFER MEMORY 
READ ADDRESS 



This Is the location of the first page 
comm buffers. 



of data 



BUFFER MEMORY 
RWL ADDRESS 



This is the location of the first page of data 
comm buffers with the RWL bit set. 



PTR TO REQUEST Q PTR This Is the address of the Request Queue 
pointer. 



Bits 



7 

1 [ 



Page 



7 
) ( 



Bus 



15 

1 [ 



Offset 



8 



PTR TO RESULT Q PTR 



This Is the location of the Result 
pointer. 



Queue 



Bits 



7 


7 


7 


15 


8 


I 


] I 


1 [ 


I [ 


1 



Page 



Bus 



Offset 



PTR to AVAIL.POOL PTR This Is the location of the data canm Available 
Pool pointer. 



Bits 



7 


7 


7 


15 


8 


I 


1 I 


1 I 


1 [ 


] 



Page 



Bus 



Offset 
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LINE VECTOR TABLE 



This Is an array of 16 2-byte entries, one per 
port. Each entry Is the address of the related 
Line Table entry. Unused ports have an address 
of «FFFF«. Port Is used for I nterprocessor 
communication (PI). This port should have an 
entry of flFFFFfl. 



NOTE 



HC LINE NEXT POINTER 



For entries HC LINE NEXT POINTER 
through HOST LINE PRIORITY, for 
the pirposes of SCHEDULER, host 
control (HC) Is treated as an 
additional line, and has a 
pseudo LINE INFO area. This 
group of fields Is that area. 

This Is the forward link to the next line. As 
K; Is always the "last line," this points to the 
first line In the queue for Line Manager. 



HC LOOP FLAG 

HC LINE FUNCTION 



Unu sed . 

Address of code to be executed by host control 
when It gains control. 



M.AX STATION T.ABLE SIZE Indicates the size of the station tables used In 
this OOP (either normal or extended). 



HC LINE CHANGE COUNTER HC only runs every nth cycle (currently every 
10th). This counter controls the size of the 
cycle. 



HC LINE BACKWARD 
POINTER 



This Is the backward link to the previous HC 
I Ine. 



HOST LINE PRIORITY 

PI SEND HEAD 

DCP RESULT 
HEAD ADDRESS 



This field Is always 0. 

DCP memory address of the head of the PI queue. 

Address In buffer memory of the head of the XP 
result queue. 



DCP RESULT 
TAIL ADDRESS 

DUMMY STATION TABLE 



Address In buffer memory of the tall of DCP 
result queue. 

Used as a work area during Station Table 
operations. 



LINE IhFO 

BASE ADDR TABLE 



This table contains the address of the Line 
Table entries In LLN order. All unused entries 
are fll led with SFFFFi. 
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RELOAD IN PROGRESS 



This l-byte field Is set to SFFe by the OS to 
request that the DCP enter Its IDLE state In 
preparation for reloading. This field Is reset 
(eooe) by the OCR when It Is "Idle". 



ENHA^CE^€NT BYTES 



Reserved . 



NPC VERSION 



This Is the version of the NDL Post Compiler 
(NPC) used to generate the microcode file 
currently In the OCP. 



STATE SAVE AREA 



If the DCP develops a problem or becomes "hung," 
this area al lows the same degree of debugging as 
any other processor. A detailed description of 
the State Save Area Is contained In the OS 



ERROR NUMBER 



This field In the State Save Area Is special to 
the DCP processor. Error numbers and their 
meanings are: 



$00i : Hardware error. 

801 S : Interrupt error. 

An unexpected Interrupt has occurred. 

e02S : NDL error. 

The DCP has detected an error In the 
supplied NDL that makes firther execution 
unsafe. 



8038 : Initialize error 
I ric lAyr urancnea 
gone through Initialize code twice 



IMC lAyr urancnea to aaaress u, ana nas 



Errors 8028 and 8038 will probably require TIO 
or plant resolution. 

The values In the State Save Area have no 
meaning unless the data ccmm was active at the 
time of the dump. 

LINE INFORMATION AREA 

Information regarding the lines under control of this DCP is held in three parts. The first part is the 
"Line Number" area. This area holds all pointer information work areas, flags, etc. The second part 
is the standard CMS "Line Table." The third part is the "Station Table" entries for all stations on 
this line. 

LINE NUMBER 



NEXT POINTER 



This 2-byte field contains the absolute address 
of the next line Info area In the "Round Robin" 
queue. 
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PORT NUMBER 



This Is the physical port number. It Is 
maintained as a bit mask where Port 2 = •041, 
port 7 » I80t. 



FUNCTION 



This Is the address of the microcode that 
handles the anticipated event. If the line has 
never been made ready, this field will be 0. 



RETURN POINTER 



The code address to return to 
function completes. 



when the active 



BACKWARD POINTER 



Points to the previous entry In the "Round 
Robin" list. Only used In queue delinking. 



PRIORITY CODE 



The line priority to be used when placing this 
line Into the top-down Manager queue. 



PRIORITY PTR 



ACTIVE STATION PTR 



ACTIVE STATION 



Points to the ne«t line at the highest priority. 
If fhls Is the only one, then this field will 
point to Itself. This field Is used In the Line 
Manager for top-down scheduling. 

Contains the DCP memory address of the Station 
Table entry of the currenly active station (If 
any). 



Contains the RSN of the currently 
station (the NDL variable "STATION"). 



active 



ACTIVE STATION 
VECTOR PTR 



Contains the DCP memory address of the current 
station's Station Vector In the Line Table. The 
Station Vectors are contained In the CMS table 
station descriptors. This field Is redundant 
for the dump reader, as the appropriate entry 
can be readily found by use of the RSN field. 



W0RK1 thru W0RK3 
CURRENT BUFFER 



Temporary storage areas. 

Absolute address of the base of the current 
buffer. 



THIS BUFFER SIZE 



Contains the remaining buffer size. 
Is updated at buffer crossover. 



This field 



THIS BUFFER SIZE SAVE 



This Is used to store "THIS BUFFER SIZE" at 
buffer crossover time. This Is necessary to 
enable the system to correctly handle a 
BACKSPACE after the last character has been 
stored. 



SAVE POINTER 
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Used by subroutines that enter the Manager. This 
Is not the normal mode of entry. It Is used 
vrfien a needed return address sits on the top of 
the NBDS stack and the future Integrity of the 
stack Is In danger due to an Impending yield to 
another line. 



BUFFER SIZE 



Contains the remaining buffer space. This Is 
maintained In twos complement and Incremented 
with each character stored. A vajje of 8FFFF8 
Indicates overflow. 



BUFFER COUNT 



TERMINAL NUMBER 



The absolute address of the next character 
position to be read from or written to. 

Contains the logical terminal number associated 



INPUT CHARACTER 



CHARACTER 



Contains the translated and checked Image of the 
last character on the line. (NDL CHAR) 

Contains the last character as It appeared on 
the line. (NDL luhar) 



TIMEOUT 
TEXT SIZE 



Used to store S-OP-deflned times. 

Contains the current amount of text accumulated 
or transmitted so far. This Is maintained In 
ones complement form. It Is updated only on 
buffer crossover by the amount In 
THIS.BUFFER.SIZE. 



RETURN TO POINTER 

CRa 
see CRCM 



Contains an S-OP address where control will be 
returned when current function Is completed. 

Holds lower byte during CRC calculations. 

Holds BCC or upper CRC byte during BCC/CRC 
aeneratlon. 



ADAPTOR DESCRIPTOR 
DATA SET CE SCRIPT OR 
MESSAGE HEADER/LENGTH 
TERMINAL SAVE Q LIMIT 



A copy of the DC I hardware register. 

A copy of the DCI hardware register. 

Contains MAXINPUT for the current terminal. 

Contains the limit for the Output Save Queue of 
a given station. The limit Is specified in the 
station's Terminal Table. Because the terminal 
tables are not stored in DCP memory, the 
TERMINAL SAVE LIMIT Is stored In the Line 
Configuration area and updated at station change 
time. 



YIELD COUNTER 



Used to ensure that a high speed line does not 
iTcnopolIze a data comm processor's time. 



AT LEAST TWO 
CHARACTERS 



Used to determine If certain BDLC receive S-OPs 
have received at least two characters. 
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STREAM A 



Used to buffer TRANSMIT TEXT data from data ccmm 
space to the adaptor. 



STREAM B 



Same as Stream A. 



ADAPTOR ABORT INFO 



This Is two 1-byte fields which contain 
Information to be copied to the RESERVED and 
SUBQ fields of a Line Not Ready result header 
(with adaptor fault event set). These fields 
are also valid In the case where a function Is 
returned with the result UNABLE TO INITIATE 
caused by an adaptor mismatch. The following 
Information Is helpful: 







Corresp. 




Subnet 




Reserved 




Queue 


Description 


Ft 


eld 


Description 





No CTs after 
8 seconds 




n/a 




1 


No adaptor 







Delay operation 




present 




1 
2 

3 

A 

5 


Transmit 

Rece 1 ve 

Switched line establish 

dial out 

Dial out 

Adaptor lost 


2 


Adaptor not 
dial out capab 


le 


n 


Where n = ID of adaptor 


3 


Line address 
requires dual 


ENDC 


n 


Where n = ID of adaptor 


4 


LEM link parity 





Read 








1 


Write 



MESSAGE HEADER POINTER Contains the absolute address of the message 
area currently In use. 



HOST WORKl thru 4 



Used as host control work areas. 



DUMMY TALLY, Used In place of STATION TALLY, STATION 
DUMMY DESCRIPTOR, DESCRIPTOR, and STATION POINTER when an Invalid 
DUMMY STATION POINTER station has been chosen. 



FLAGS 



These fields reflect the state of the line. 
Individual bytes contain the following flags. 



FLAG 1 



Bits 


Message 


7 


NOT USED 


6 


CRC 
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Meaning 



The CRC toggle In NDL. If TRUE, 
horizontal parity Is generated. 
If FALSE, horizontal parity Is 
not generated. 



Bits Message 

5 NO. TRANSLATE 

4 SYNCS 

3 FULL DUPLEX 

2 TRANSPARENT 



Meanfng 
No translation 
Store received syncs 

Set for ful I duplex 

Line Is In transparent mode 
Set/Reset by binary = TRUE/F^SE 



MIDDLE SHIFT MODE When using caseshlft translation, 
UPPER SHIFT MODE these flags define the shift mode 
In effect. 



FLAG 2 



7 RCV TEXT 



Set while receive f^xf Is In pro- 
gress so that the common receive 
manager can distinguish a RCV 
text from a RCV character. 



6 ZERO TIMEOUT 



5 INPUT FLAG 



The last receive Instruction had 
as Its time value. (0 requires 
special handling In the manager.) 

If set line had no output space 
for half-duplex, this Implies that 
line Is In line control or Input 
request mode. 



FLAG 3 



4 LINE CONTROL 



3 SPACE AVAIL 



2 HORIZONTAL.OOD 



1 CRC.1 



SYNC/ASYNC 

7 FUNCTION IN 
FK OGRESS 



6 VERTICAL EVEN 



Set when NDL Is running the line 
control or auxl 1 1 ary 1 1 ne control 
of the program for this line. 

Message space Is available. Set 
after successful getspace, or on 
entering an output request 

Set If using odd horizontal, 
parity. 

indicates CRC polynomial In use: 

: x»*i6tx»»l5+x»*2+I 

1 : x**16tx»*12+X**5+1 

TRUE Implies ASYNC. 

If set, HO does not get a message 
off the request queue for this 
line. Also, inhibits S-OPs 
from interrupting the line. Irre- 
spective of the state of the line 
(busy). 

Set if even vertical parity Is 
present. 
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Bits Message 

5 NEW CHAR PRS^^" 

4 STA.NRY. PENDING 



LN.h«^Y. PENDING 



Meaning 

Set I f rece I ve man ager rece 1 ved 
new character fran line. 

A Make-Station-Not-Ready request 
has been made for this station. It 
will be done after TH I S. FUNCTION. 
Implies that line (busy) Is TRUE. 

As above, but for line. 



>WT/RCV LAST Indicates whether the most recent 

function was a transmit or receive. 
Used In byte variable and toggle 
accessing for values that are main- 
tained on the adaptor (1 for each 
side XMIT and RCV). True = RCV. 

ABORT IN PROGRESS In a multl-MCS environment, the DCP 
Is In the process of Informing all 
MCPs that a line abort has occurred, 

FLAG.FILLING The BDLC line Is currently flag 

filled. 



FLAG 4 7 WAIT FUG Set If line Is In Walt. 

6 AUX ACTIVE Set if auxiliary line Is In line 

queue. 

5 AUX Indicates that this Line 

Information area Is an auxiliary 
of a full-duplex pair. 

4 IGNORE BREAK Indicates to the transmit 

messenger that the S-OP wishes 
to Ignore a break condition on 
an ASYNC line and underflows 
on a SYNC 1 1 ne. 
The receiver expects a BDLC flag. 

Reflects the state of transparent 
for the most recent XMIT/RCV. 
Aids In the retrieval of the 
character, since transparent could 
have changed state from the time 
the character was received and 
its access. 

ADAFTOR IN USE An Instruction requiring the 

presence of a line adaptor has 
been executed. 



3 FLAG EXPECTED 



2 OLD TRANSPARENT 
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FUG 5 



Bits 

7 
6 

5 
4 



Message Meaning 

NOT USED 

TERMINATING BLOCK Set If terminating block. 

NO LINE CTRL Set If shouldn't re-wrlte line 

control after pending resolution. 



DCIB TRUE 
HOST MCS FLAG 

NOT USED 



Set If the line adaptor Is DCIB. 

Indicates logical state of the 
associated MCS. 



INV FRAME 



Set If the BDLC line has received 
an Invalid frame. Its use Is 
Internal to the routine that pro- 
cesses receive errors. Should be 
outside that routine. 



ABORT LINE Set i f LEM line error occurred 

during Make-Line-Ready process 
before Line Linked Is set. 



FLAG 6 



LINE LIM<ED Set If Line Ready process has 
linked line Into line list. 
LI ne can be made Not Ready at 
this point. 

LINE LOVD Indicates which stream field 

must next be loaded with trans- 
mit data: = String A 
1 = string B 

LINE STREAM Indicates which stream field is 
current: = string A 
1 * string B 

LINE BITS Set If line Is BDLC. 



TERMINATING 
DISABLE OUTPUT 



3 NOT USED 
2 NOT USED 



Set If Terminate Disable Input 
Is being processed to distinguish 
It from a Terminate. Error is 
common code. 



1 



NOT USED 
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INVALID OSR Set when the DCP firmware notices 
a peculiar condition on the line 
adaptor. 
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COUNT A 
COUNT B 
PRIMARY POINTER 



CO LINE POINTER 



LNE PENDING MCS ID 



LNE LOG LN RDY COUNT 



LNE HOST MCS I D 



LNE MCS LOG STATE 



I IMF SKR MCS DATA 



LNE LNR MCS DATA 
Ll^€ TABLE 



STATION TABLE 



The number of characters In stream A. 

The number of characters In stream B. 

Address of the LINE INFO AREA of the primary 
llneofa full-duplex pair. For half-duplex 
pair, for a half-duplex line, or for the 
primary, this will point to Itself. 

Address of the LINE INFO AREA of the aux line of 
a full-duplex pair. For a half-duplex line, this 
field Is iFFFFfl. For the aux line of a full- 
duplex pair, this field points to Its primary. 

This 1-byte field Is used If an MCS Is making a 
line Ready/Not Ready, and holds the MCS relative 
routing number of the requesting MCS. This field 
is used later (when the action Is finished) to 
route the result of the line condition back to 
the parent MCS. 

This 1-byte field Is used to hold the nunnber of 
lines the MCS has ready. 

This 1-byte field Is used as a Save Area for the 
MCS 10, and Is used In relationship with any 
pending operation (such as making a line Ready) = 
When the operation (function) is completed, this 
field Is copied Into the result descriptor 
header. 

This array Is 16 bytes long, and Is used to hold 

Information on the state of the lines (one byte 

for each line). 800a indicates the line Is Not 
Ready, SFFS Indicates that It is Ready. 

This 2-byte field Is used to hold the MCS data 
field of a MAKE. STAT ION. NOT .READY nessage header 
If that header encounters a Pending condition. 
This field will be copied to a new header and 
retirned to the MCS when the Pending condition 
is resolved. 

Same as above, for MAKE.LINE.NOT.READY. 

The meaning of the contents of this table are 
identical to that described in the NDL tables in 
this section of the manual. For Infonnatlon on 
the usage of the Line Table, refer to the Data 
Oanmunlcatlons Subsystem Reference Manual , form 
1090909. 

This table Is Identical to the area described In 
the NDL tables found In this section. For 
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additional Informa+Jon on the Station Table, 
refer to the Data Communications Subsystem 
Reference Manual . 



BUFFER MEMORY 

The third and last area of the data comm dump section is the set of data comm buffers. Buffers are 
listed in relation to the structure to which they belong. All buffers are laid out in the following manner: 

Byte Description 

0-3 Link to next buffer In this message with SFFFFfi 

the last buffer. 

A ~ 1 I* 4-i. t .. t .. 4-Uc ■«t*.*4. U...C-«A» ^* ^ «^ ^«^ t J. 1 — k. 

~r I II llll^ la 11 lb liiai uuiioi \j\ a iiiOooa^o f I I LV fills 

to the next message. If It Is not the first buffer, 
the field Is SFFFFi. 

8 - n Message text. 

NOTE 
In the first buffer of a message, the 
first 36 bytes contain the MCS header. 

AVAILABLE BUFFER POOL (ABP) 

The Available Buffer Pool is a set of buffers. The size was allocated by the DC BUFFER field of 
SYS.CONFIG and by the NDLSYS file using the DCP section buffer fields. All buffers are dumped 
to allow a trace of a recent message. By using the two link fields, buffers can be linked forward or 
backward. Information on the linking fields follows. 

ABP READ WITH LOCK A 1-byte field used by the Read-Wlth-Lock 

hardware (8006 = unlock, iFF« = locked). 

ABP PROCESSOR ID This contains the ID of the processor using the 

ABP. 

ABP COUNT This field contains the number of buffers In the 

ABP. 

ABP HEAD This field points to the head of the ABP. 

ABP TAIL This field points to the tall of the ABP. 

The ABP buffers are located here in the printed dump. 

RESULT QUEUE 

The resuh queue area is laid out similarly to the ABP. The fields are identical in function to those 
of the ABP. 
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REQUEST QUEUE 

The request queue for each DCP number is given here. The fields are identical in function to those 
of the ABP. 

SUBNET QUEUE 

The contents of each subnet (NDL file) is given here. The fields have the following significance: 



QUEUE NUMBER 
QUEUE LIMIT 

QUEUE COUNT 
QUEUE HEADAAIL 



Analyzer develqoed reference (logical Q no.). 

The current queue limit for this subnet. 
Default value Is 2. 

The number of messages In this subnet queue. 

The addresses of the head and tail of the subnet 
queue. 
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QprrinM in 

TASK PROCESSOR 
INTRODUCTION 

This section of the manual provides a field-by- field description of the Task Processor (TP) portion of 
the dump. Data contained in the TP section includes: 

Input and output mailboxes used to communicate with the OS processor 

Pointers used to locate system and task structures in the task processor memory 

State Save Area, used to store information when a nonrecoverable error is detected 

Analysis of memory utilization 

Breakdown of interpreter and task run structures 

Status information for each task 

A section titled "Task Processor on BUS nn," is printed for each TP on the system. The first indica- 
tion of a task processor failure is usually the message, "Task Processor <BUS ADDRESS > 
LOGICALLY NOT READY," displayed on the SPO. In this instance, the procedure discussed in the 
following paragraphs should be performed. 

INITIAL DUMP ANALYSIS 

There can be one of two reasons for a task processor to be in a LOGICALLY NOT READY state. 
The first reason is that the task processor detected an internal failure and stopped communication with 
the OS processor. 

The second possible reason is that the OS processor failed to receive a response from the task processor 
which the operating system had polled. 

In both of tbpSP raSPS thp OSI frppypc tJlP tacV nrnrpccnr anH Qttfmntc tr\ r^ranta o c\;trtom Hiimt^ TJ/iiii 

ever, it should be noted that, in the first case, a processor maintenance entry will be logged. This entry 
contains the same information as the State Save area. 

The initial step in dump analysis is to identify the bus address of the failing task processor. This can 
be achieved by looking at the system log or by examining one of the following fields in the system 
dump: 

Frozen Processor field found in the Dump File Parameters section (page 2 of the formatted dump 
file) 

Dump File Map (third section in the dump file) 

PI Dead Processor found in the PI Data Area of the dump's OS section (which follows the History 
Communicate Table). 

The Save State Address is always primed. If the OS detected the error, the Save State information 
will be invahd and will be initialized to 3 bytes of @FF@, 49 bytes of @00@, and 10 bytes of @FF@. 

If the task processor detected the error, the Save State information will be valid. 

If the error number is @47@, the error was hardware-detected. Interrogation of the IC Status fields 
found in the State Save Area will indicate the type of hardware failure. More detail on State Save 
Area analysis is contained in section 8 of this manual. 
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If the error number did not indicate a hardware failure, the fields 1MB FUNCTION and 1MB FLAGS 
should be examined. These fields indicate the last function that was performed and the current status 
of the input mailbox. Possible entries and their messages are discussed later m this section. 

Reoeat this step for the OMB REQUEST FUNCTION and the OMB FLAGS. If the reason for the 
morcannotbT determined, further analysis will be required. The rest of the task processor fields are 
detailed in the following subparagraphs in the order in which they appeared m the dump. 

TASK PPROCESSOR ON BUS nn 



AOOUNT 



STATE SAVE AREA 
ADDRESS 



This Is the address resolution count. The 
Information shown here Is used In the detection 
of thrashing. 

This field will always be primed to the address 
of the State Save Area. 



MAILBOX DESCRIPTIONS 



The Input Mailbox is used for messages from the OS to the TP. The Output Mailbox is used for mes- 
sages from the TP to the OS. For a full explanation of mailboxes and their use in interprocessor com- 
munication see section 4. 



irPUT MAILBOX (the) 
TEXT 



This area Is used to store the message passed. 
The exact usage Is defined by the request 
function field. The text area contains the 
Fetch Communicate Message (FOI) If communicate 
Information Is Indicated In the request function 
field. 



1MB REQUEST FUNCTION 



This field Is used to Indicate the type of 
Information In the text area. When the request 
bit (MSB) Is set In the 1MB flags, the OS Is 
requesting the task processor to perform a 
function. 



These functions are as fol lows: 
«07< Command handler. 

•Oet Interpreter load. 

•09* Monitor action. 



•FFi Data move function. 

Parameters to these functions are In the 1MB 
text area, as shown In figures 10-1 and 10-2; 
responses are shown In figure 10-3. 

If the TP had previously requested, by means of 

Its output mailbox, action In the OS, there may 

be a result to be passed back to the TP. In 

this case, the request function will be the 
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TASK PROCESSOR INPUT MAILBOX 

TEXTAREA-16 BYTES 

FOR NON INTERP ACTIONS THE COMM.AREA CONTENTS WILL VARY 
DEPENDING ON WHETHER THEY ARE RECEIVED FROM THE OS OR ARE TO 
GO TO THE OS. THEY ARE ALSO ACTION DEPENDENT. 

OS-»C0MMAND HANDLER (FUNCTION ID = 071 

BYTEO- 00 RUN (LOAD) 

01 PREPARE TO SUSPEND 

02 PREPARE TO WAIT LONG 

03 REQUEST FPB NO. 

04 REQUEST SEG. SIZE 

05 PREPARE TO MONITOR 

06 PREPARE TO REMOVE JOB 






1 


2 


3 


4 


S 


a 


7 


8 


9 


10 


11 


12 


13 


14 


15 



RUN 00 VM^FILE^ PRIORITY SIZEOFTCB 



PRIORITY HELD IN 2 LSB. 1=C, 2=B, 3=A. 



PREPARE 
SUSPEND 



FILEIDOF 
VM FILE 



"sUvE ^ ' °* DESIGNATES "SAVE DATA STRUCTURES." 01 DESIGNATES "RM DATA STRUCTURES.' 



GET FPB NO. 03 '''**'* ^'^ 

ID NO. 



GET SEG NO. 04 ^p" ?.'!? 



PREPARE 
REMOVE 



FILEIDOF REMOVE 



-02 DESIGNATES "SAVE DATA STRUCTURES." 01 DESIGNATES "RM DATA STRUCTURES". 



Figure 10-1. TP Input Mailbox Format for Function 07 



TASK PROCESSOR INPUT MAILBOX 

TEXT AREA = 18 BYTES 

OS -> MONITOR ACTION (FUNCTION-ID - 0B| 

BYTE = OPCODE = 02 REQUEST "BUSYNESS" FACTOR 

ELSE CONSIDERED AS PROCESSOR POLL. 

OS-»COMMUNICATE REQUESTOR (FUNCTION-ID - FF) NOTE: REQUEST BIT IN FLAGS IS RESET . 
BYTES 13,14,18 = FCM 

OS ■♦INTERPRETER LOAD (FUNCTION ID = 08|. INVOKED AT WARMSTART. 






1 


2 


3 


4 


5 


6 


7 


a 


9 


10 


11 


12 


13 


14 


15 



FILEIDOF 
INTERP FILE 



SIZE 



OFINTERP.SEQ.TABLE 



SINCE AT WARMSTART THE 08 WILL SUSPEND WAITING ON A RESPONSE 
TO THIS REQUEST, FAILURE OF THE TP TO PROVIDE SUCH A RESPONSE IS 
FATAL TO WARMSTART. THE SYSTEM WILL HANQ. 



Figure 10-2. TP Input Mailbox Format for Functions 08, 09, FF 
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TASK PROCESSOB OUTPUT MAILBOX 
TEXT AREA- ie BYTES 



GOOD 

I 
BAD 





01 


NA 






ELSE 1 




SY810 


RESULT 1 



I 



01 

oe 



01 

o» 



NACK * 



» GOOD 

I 



(NOTE) 



I I 



RESPONSE FROM ACTION 07, 
TO OP-CODE 00 



RESPONSE FROM ACTION 07, TO OP-CODE 01 OR 06. 



RESPONSE FROM ACTION 07. TO OP-CODE 03. 



RESPONSE FROM ACTION 07, TO OP-CODE 04. 



D 



'' :' 



NOTE: BYTE 4 = 01 - SUSPENDED 
06 — REMOVED 



RESPONSE FROM ACTION OS. 



Figure 10-3. TP Output Mailbox Format 



action ID of the requesting action, the request 
bit will not be set, and the 1MB twd" area will 
contain the response- 

1MB REQUEST PROCESSOR This field contains the bus address of the 
processor originating the request. (Not used by 
task processor.) 



1MB RESULT PROCESSOR 



1MB RESULT FUNCTION 



This field contains the bus address of the 
processor this message went to. (Not used by 
task processor.) 

This field contains the ID of the action that Is 
to receive the result. When the function field 
points to a TP action, the ID Is an Index Into 
the status block address array. 
Refer to the "SB address array" description In a 
later subsection. 



1MB SYSTEM MIX NUMBER This field contains the mix number of the number 
of the Job Identified In the OS processor Mix 
Table. Information passed Is associated with 
this Job. 



10^ 



1MB AWAITING MAILBOX Not used. 

1MB FLAGS The bit assignments of the flags are as follows: 

MSB 7 - Request 

6 - Unused DCP 

5 - TP error 

4 - Rejected by TP 

3 - Accepted by OS 

2 - Given to OS 

1 - Accepted by TP 

LSB - Given to TP 

The following flag values Indicate the most 
common transaction sequence and may help to 
iHftn+lfw the status of the text area: 

<0B« Mailbox owned by OS 

88 1i Mailbox contains data for TP 

tBAt TP has accepted the Input message 

«06i may also be seen In the flags field. This 
Indicates a successful data move by the TP. 

The meanings of the flags without the "8" bit 
are also as above except that the text contains 
a response from the OS rather than a request. 

OUTPm- MAILBOX (0MB) TEXT 

Text same as for Input Mailbox. 

OMB REQUEST FUNCTION This field Is used to Indicate the type of 
Information contained In the mailbox text area. 
Values here represent action- IDs In the OS. 

When the flags request bit Is set, the following 
flag values are used: 

ei5i REO-SYSMESSAGE TP request to display Information on the 

ODT/Remote SPO. 

830« REQ.IO TP request to bring a structure Into Its 

memory. 

«47t REQ. RUNNING TP Informing the OS that a Job has been 

loaded or restarted, and should now be 
marked as executing. 

848i REQ.REMOVE TP Informing OS that a task has been 

suspended or terminated as requested. 

«4D« REQ. THRASHING TP Informing OS that a thrashing 

condition exists. 
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•52i REQ. JOB. ERROR TP Informing OS that an error has been 

detected. Probably DS-DP condition. 



«eB« REQ .MONITOR 



Invokes DUMMY action In OS to confirm DP 
still alive. 



•FFi REQ .COMMUNICATE First byte of text = contmun Icate. 

0MB request processor, CMS result processor, 0MB 
result function, 0MB awaiting mailbox, system 
mix number are the same as 1MB. 



0MB FLAGS 



The bit assignments of the flags are as follows: 



MSB 



LSB 



7 
6 


: Request 
: Unused DCP 


5 


: TP error 


4 

3 
2 


: Rejected by OS 
: Accepted by OS 
: Given to OS 


1 




: Accepted by TP 
: OS acknowledgment 



The following flag values Indicate the most 
common transaction sequence, and may help to 
Identify the status of the next area. 

e02« Mailbox owned by TP 

«4« Mailbox contains data for OS 

$iM OS has accepted the mailbox request 

«02i Mailbox owned by TP 

The meanings of the flags without the "8" bit 
are the same as above except that the text 
contains a response from the TP rather than a 
request. 



SIGNAL OUT LOCATION 



This Is the location where the task processor 
sets a flag to alert the OS to check the 
ma 1 1 box. 



ERROR OFFSET 



This field points to the location In the task 
processor code where the error was detected. 



INTERPRETER SAVE AREA 



INTERP 


KDUMP, 


irn-ERP 


SINTFLAG, 


INTERP 


SI COUNT, 


INTERP 


LDUMP, 


IMTERP 


TCBPTR, 


INTERP 


TCBPAGE, 


INTERP 


RTRNDUMP, 


INTERP 


JDUMP, 


INTERP 


OOMfPTR 



These are fields used by the Interpreter to save 
off Infc-matlon during Interrupt handling, ere, 
txj enable control to be reinitiated at the 
correct place. 
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POINTER FIELDS 



OS BUS 



Current Task 



OS Request Task 



This field contains the bus address of the 
operating system Interrupt handling to enable 
control to be reinitiated at the correct place. 

This field contains the ID of the task which has 
control of the task processor. 

This field points to the task requested by the 
OS. 



Terminate Tasks Task 



Current Message 



Terminate Queue 



This field points to the task which Is 
terminating. 

This flAiri nnlnts +o +ho in»IIK/^v ^«r.+ «lnln« 

~ ' - ..1-..—^ ^,,.W, J, 

message for the current task. 

This field points to the tasks waiting to be 
terminated. 



Task References 
First Job 
Ready Queue 

Please Yield 



This Is a list of user Jobs or TP-created tasks. 

This field points to the first user task. 

This field points to the next Job which will 
obtain control of the task processor. 

The OS Is requesting the task processor to give 
up control of the current task. Possible values 
are: 



Al locates Cal led 
Allocates Idled 
Allocates Measure 



flFFt = OS requesting processor to yield control 
iOOi = No request from OS 

These fields are used to determine processor 
activity. 



Page Reference 



Last Page 



This field points to the pages of the task 
processor . 

This field Indicates the number of pages on the 
task processor. 



Blocks Lock 



ICB First Page 



«00i = Unlocked; *^F« = Either a TCB, PCB, or 
ICB Is In the process of being created/deleted. 
Wh 1 1 e I n a I ocked state no one may make or 
delete from this block- 

This one byte field points to the page of the 
first ICB. 



ICB First Location 



This field points to the location on the page of 
the first ICB. 
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ICB Last Page 



ICB Last Location 



This field points to the last ICB on the list on 
a particular page. 

This field points to the location on the page of 
the last ICB. 



Mai lout Lock 



The PCB and TCB pointer fields, which are the 
next eight entries, are the same as the ICB 
pointer fields above. 

A value of iFFt Indicates a locked condition. 
This lock Is used to control access to the 
mailbox which can be used by only one task at a 
time. 



OS Processor 



Task Processor 



This field contains the bus address of the OS 
processor. 

This field contains the bus address of the task 
processor. 



H Bugspace Location 
Bugspace Location 
Num Debug Text 



These fields will always have a value of zero. 
They are regarded as reserved fields. 



Task Run Space 
No Task Space 



Segments 
Task Kind 



ihis iieid coniains i no ovjuTess of the n^vi iSSr* 
to be loaded. 

A value of iFF8 means there Is no space to load 
a task on this processor. 

These are compiler-related fields. 



SPACE ANALYSIS 

This area reflects the state of each page of memory in the task processor. Since hardware memory 
addressing is not continuous across pages, memory management of each page is effected independently. 
For each page of memory present, the following fields are Hsted: 



Page Number 



First Space, 
Last Space 



This field Indicates the memory page In the task 
processor. 

These fields contain the addresses of the lowest 
and highest spaces In the page. The spaces of a 
page are linked forward and backward In memory 
address order. Therefore, the spaces of a page 
can be searched In either direction. 
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Lock 



A value of tFFC means locked. Since each page 
has Its own lock, memory management In several 
pages can proceed concurrently. This lock Is 



used to control memory al location on each page 
of memory In the task processor. This lock can 
be used by only one task at a time. 

Task Wafting This field contains the task record addresses of 
tasks waiting on a lock. 

First Available This field contains the address of the lowest 
addressed available space. All the available 
spaces In a page are linked together In memory 
address order. 

GS Count This Is the Get Segment Count that Is used In 

detection of thrashing. 

Blocks The number of PCBs, TCBs, or ICBs contained on 

that page. 

Each page of memory in the Space Analysis section contains a table of the space allocation of the 
memory on that page. It contains the column headings NEXT, LAST, SIZE, STATE, and USED. The 
information under these headings is explained as follows: 

NEXT The NEXT field Is the forward link to 

adjacent spaces. LAST (preceding entry ) 
+ SIZE = NEXT (unless NEXT = NULL). 

LAST The LAST field Is the backward link to 

adjacent spaces. An example of how to 

read the NEXT and LAST fields Is given In 
figure 10-4. 

SIZE This field Is the size of the space In 

bytes. Inclusive of the space record 
Itself. 

STATE The state of the space can be either 

available, overlayable, or non- 
over layable. 

USED This field Is a usage count for S- 

SEGMEMTS. 

i07« = used, 8001 - available. 
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PACE NURBER 


02 














FIRST SPACE 


0000 














LAST SPACE 


FFE6 














LOCK 


00 














TASK WAITING 


0000 














FIRST AVAILABLE 


1A76 














bS COUNT 


08 














BLOCKS 


0001 














ARCOUNT 


A4FF 


















NEXT 


LAST 


SIZE 


STATE 


USED 






»»*♦ 


*< *• 


• «•« 


*«•«« 


• *•• 






OOOB 


0000 


ocob 


FF 


NON OVERLAYABLE 


07 






0167 


00 00 


015C 


80 


OVERLATABLE 


07 






02A9 


OOOB 


0142 


80 


OVERLAYABLE 


07 






0*97 


0167 


01EE 


80 


OVERLATABLE 


07 






0776 


02A9 


02DF 


80 


OVERLAYABLE 


07 






09A0 


0*97 


022A 


80 


OVERLAYABLE 


07 






0FB9 


0776 


0619 


80 


OVERLATABLE 


07 






113A 


09 AO 


0181 


80 


OVERLAYABLE 


07 






1«6e1 


0FB9 


0334 


80 


OVERLAYABLE 


07 




1 FF3A 


113A 


EACC 


00 


AVAILABLE 


00 1 




FFE8 


146E' 


OOAE 


FF 


NON OVERLAYABLE 


07 






0000 


FFiA 


0008 


FF 


NON OVERLAYABLE 


07 



A sample space allocation table is shown above. Assume that you wish to locate the last area of 
AVAILABLE space in the Hex dump. The line of information relating to this area has been outhned 
so that it will stand out. This piece of memory, of size EACC (in Hex), is located between two ad- 
dresses of 146E. These addresses are the NEXT of the preceding line(i) and the LAST of the hne which 
follows(2). This indicates that the available entry is located at 146E in this page. 



Figure 10-4. Example of How to Read NEXT and LAST Fields 
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BLOCKS 

There are three kinds of blocks: Interpreter Control Blocks (ICBs), Program Control Blocks (PCBs), 
and Task Control Blocks (TCBs). There is an analysis section for each kind of block in the dump. 

ICB ANALYSIS 

This area contains interpreter information. There is an ICB ANALYSIS section for each interpreter 
in a task processor. A description of the fields as they appear in this section is as follows: 

iCB Page This fieid indicates the page where the iCB is 

located. 

ICB Location This fieid Indicates the location of the ICB on 

the page. 

Space Next, These are forward and backward memory links In 

Space Previous the space record. 

Space Size This field Indicates the size of the ICB in 

bytes. 

Space State The space state can be either available, 

overlayable, or non-over I ay able. 

Space Used «07« indicates recently "used", and tOO* 

Indicates "available." 

The BLOCK HEADER is comprised of the next six fields appearing in the dump. This area precedes 
all ICB, PCB, and TCB records. These fields provide a description of the block, and are Unked to 
"revious blocks of similar t^"e on a task •Processor '^a^e. The fields are named Next Pa"e Next Loc 
Previous Page, Previous Loc, Kind, and ID. 

The following fields appear in the dump after the Block Header: 

ICBS Users This field contains the number of users for a 

particular ICB in a task processor. 

ICBS Flags Not used. 

ICBS CST BASE Contains the first byte of the ICB file 

descriptor. This is the starting location of 
the ICB file. 

ICBS CST Limit Contains the last byte of the ICB file 

descriptor. This is the ending location of the 
ICB file. 

PCB ANALYSIS 

This area contains information regarding the programs assigned to a specific task processor. The fields 
in this section are the same as those of the ICB Analysis area. 
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TCB ANALYSIS 

The standard Block Header fields are followed by a TCB descriptor and a segment table. 

TCB Descriptor 



Priority 



I Seg 
I Off 
CST Size 
CST Sector 
1ST Size 
1ST Sector 
DST Offset 



This field Indicates the external priority of 
the user task, where 

0O1i = C 
e02i = B 
fl03t = A 

Interpreter segment number* 

Offset Into the interpreter segment. 

Size of the code segment table. 

Offset of the code segment table. 

Size of the Interpreter segment table. 

Offset of the Interpreter segment table. 

Offset Into the data segment. 



PPA Size, 
PPA Sector 



CH Return 



Data Stacit Pointer 

thru 
Control Stack Limit 

Flags 



SI ntmask 

FCM 

SPSA Seg 

and 
SPSA Off 



Size and offset of program parameter area. For 
COBOL, this area is the COP table. Not used by 
MPL. 

Not used. 

Job-related parameters. 



The flag bits are: 



MSB 7 & 6 


Used for thrashing detection 


5 


Not maintained 


4 


DS or DP condition 


3 


Suspend 


2 


Save data structi^es 


1 


Remove 


LSB 


Long wait 


maintained. 





S-program start address segment number and 
displacement. 
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TCB SEGMENT TABLE 

The layout is as in a PCB. The disk address field points to the offset within the appropriate disk file 
from where the data segment is to be loaded. This could be the VM file, the code file, or a "zero 
fill," depending on the current state of the program. FIB segments are replaced by FPB segments. The 
FPB is CMS standard. These are listed after the TCB segment table. The STE number is an Analyzer- 
computed field to cross reference the FPB to the segment table. 

JOB QUEUE 

Contains status information for each task. 

OS REQUEST TASK 

Contains information similar to an output mailbox that has not been serviced yet. 

TERM TASKS TASK 

Contains information regarding tasks waiting to be terminated by job management. 

READY QUEUE, TERMINATING QUEUE, LOCKED QUEUE 

The task processor has three queues: Ready Queue, Blocks Lock (waiting), and Terminate Queue. A 
pointer to the head of these lists is in the pointer fields. Each queue is in prioirity order, highest to 
lowest. 

COMPUTING AMOUNT OF SPACE OWNED BY A TASK 

A task uses memory for a task record, PCB, TCB, and present segments. The size of these areas can 
be found as follows: 



3l<.^ \Jl 



FkA/^Af r^ftr-i-vH* 



PCB size 



Segmnt size 



= size of PCB record plus present segments. 

Use the "PCB_ID" field In task to find PCB 
record. Size field of preceding "space" record 
contains the size of the PCB (Including block 
header, space record, and segment descriptors). 

= size specified In the segment descriptor If 
the absent bit (bit 6 In flag) is not set. 
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MAILBOX TEXT = 16 BYTES 
VALID VALUES IN BYTE 14. 



BYTE 






1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


13 


14 


15 


1 ' 1 


19 

























FF 




VERB 


ADVERB OF VARIABLE LENGTH 






- 














•— — CMS COMMUNICATE 

































■ NOT APPLICABLE ■ 



NO. OF 
SEGS 



n 4-BYTE ENTRIES 



J 



WHERE n = NO. OF SEGS 



CMS 
EVENTINHEX 



■ NOT APPLICABLE 



CMS 
EVENTINHEX 



SEG 
NO 



LINE NOJF COBOL 
PROCEDURE IN MPL 



OFFSET 



■ NOT APPLICABLE - 



- YIELD ON INTERRUPT 



71 L Yl 



ELD FOR GETSEG 



\- 



YIELD FOR SYS-MESSAGE 
(USED ONLY BY SORT) 



EACH 4-BYTE ENTRY 



SEG 
TYPE 



07 = DATA 

08 = CODE 

09 = INTERP 



SEG 

NO. 



I WORK ! 
I BLOCK I 
I >D I 



NOTE: 

NOTE THAT THE CMS COMMUNICATE WILL 
APPEAR IN THIS FORM IN THE TP OUTPUT 
MAILBOX (FIRST 16 BYTES ONLY). 



Figure 10-5. Task Record Text 



SECTION 11 
DISK MANAGEMENT 
INTRODUCTION 

Details concerning the B 900/CP 9500 disk subsystem are provided in this section of the dump. The 
configuration and physical status of all disk drives attached to the system can be ascertained, as well 
as commands handled by the disk drives. The following structures are contained in this section: 

TASK STACK - information relating to internal disk processor's operation 

State Save Area 

Pointers to structures within the disk processor's memory 

PORT TABLE - configuration of I/O channels 

COMMAND TABLE- I/O command data 

DRIVE TABLE - containing actual drive status 

INITIAL DUMP ANALYSIS 

If the disk processor encounters a hardware error causing the processor to freeze, the Hex display indi- 
cates "FOOOOO" on the lower banks of lights. Two common causes of a frozen processor are the system 
disk going "NOT READY," and the disk processor detecting a memory parity error. In these 
situations, a ROM/PROM dump needs to be taken, followed by an examination of the Disk Manage- 
ment section of the dump. 

The important areas to interrogate in this section of the dump are the DRIVE TABLE, the COM- 
MAND TABLE, and the PORT TABLE. The DRIVE TABLE entries provide the result status of the 
last I/O command issued on all drives attached to the system. Any I/O errors are indicated in these 
entries. The last I/O performed on each disk drive is identified in the COMMAND TABLE. Lastly, 
the PORT TABLE defines the existing disk drive configurations. 

If a failure has been detected within the disk processor, then the State Save Area needs to be studied. 
The error number identifies the cause of the failure. If this field has a value of @00@, then a hardware 
error has occurred. Further analysis of the State Save Area as outlined in section 8 of this manual 
will assist in identifying the type of failure detected. 

Following is a detailed description of the tables found in the Disk Management Section. 

FIRST FIELDS 

The first items encountered in the Disk Management section of a dump are explained as follows and 
shown in figure 11-1. 

OS PAGE Thfs Is a 9-byte field, of which the first two 

bytes (reversed) are the bus and page of the OS 
Processor, with the IC enable bit set. 

OS INTERFACE AREA This Is the base address of the disk/OS 

processor Interface area within the OS processor 
page 0. 
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****** HSk MANAGEMENT ******* 
****************************** 



OS PA6E 
OS INTERFACE AREA 



0021 3AU0 GOOD UOOO 00 
E366 



STATE SAVE AREA 

STATE SAVE AREA ADDRESS 3AU0 

ERROR NUMBER FF 

ACTION ID FF 

ACTION NAME FF 

Ml 0000 

WR 0000 

M? 0000 

B32 0000 

MAX 0000 

MXA OGOC 

MXB 0000 

B1FL 0000 

BO 00 

REQ 00 

XT 0000 

J 0000 

K 0000 

L OOOC 

AD 00 

TOP Of STACK 0000 

TOP OF XSTACK OOOU 

2ND OH STACK 0000 

2ND ON XSTACK 0000 

3RD ON STACK COUO 

3RD CN XSTACK 0000 

BOTTOM OF STACK OOUO 

BOTTOM OF XSTACK 0000 

;C - ERROR STATUS 00 

- STATUS WORD 1 00 

- STATUS WORD 2 00 

- STATUS WORD 3 00 

- STATUS WORD 4 FF 

- STATUS WORD 5 FF 
It - FIRST ERROR REG FFFF 



END OF LIST EXCEEDED 



0000 0000 0000 



FFFF 



DP SIZE 6D9A 

CURR TASKS 0« 

MAX DRIVES 10 

TASK INFO PTR ED56 

TASK STACK PTR 3D57 

MGR STACK PTR B502 

PORT TBL PTR FD69 

CMD TBL PTR AD6C 

DRIVE TBL PTR CD6D 

RD AVAIL PTR CC95 

RD INUSE PTR FFFF 



Figure 11-1. Sample Disk Management Section Initial Entries 
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STATE SAVE AREA 



Refer to the State Save Area In the OS Processor 
section, section 8. 



DP SIZE 



This field Is a 2-byte entry, reversed, that 
contains the number of bytes of code and data In 
use by the DSCP. Additionally, If the DFCM Is 
connected to the system, this field Is the base 
of a 5,760-byte buffer used to transfer data 
to/ from the DFCM. 



CURR TASKS 



This field Is a 1-byte entry that represents the 
drive that was told to execute a conNnand on the 
last pass through the drive scheduler* It does 
not represent the drive that might be currently 
executing a conmand* 



MAX DRIVES 



This field Is a 1-byte entry that represents the 
maximum number of drives that the DSCP will 
allow for the amount of memory present. In 32K, 
0O6t drives are al lowed; In 64K, eiOi drives are 
a I lowed. 



TASK INFO PTR 

thru 
DRIVE TBL PTR 



These fields are 2-byte reversed 
pointing to the named structure. 



entr I es 



RD AVAIL PTR 



This field Is a 2-byte reversed entry pointing 
to the start of the available result descriptor 
space. SFFFFi means that no space Is available. 



RD INUSE PTR 



This field Is a 2-byte reversed entry pointing 
to the start of the result descriptor space that 
currently contains valid result data. SFFFFS 
means that no space Is in use. 



TASK INFORMATION 

The Task Information Table consists of up to 16 5-byte entries. If the DSCP memory contains 32KB 
on page 0, there will be eight entries; otherwise, the Task Information Table will contain 16 entries. 
Each entry of this table corresponds to a drive: entry 0, drive 0; entry 1, drive 1; etc. 

Each entry of the table has the format: 



Byte 


Length 


1 


1 


2 


2 


4 


2 



Mean I ng/Contents 

Status: 6008 = Runable 

tOIC " Waiting I/O 

iFF« = Idle 
Task stack base address, two bytes, reversed 
"L" register value used as a pointer Into 
the task stack 
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STATUS NOTES: 

Runable implies that the command will be given control on some future pass through the task sched- 
uler. At this point, the command may be complete, and the OS still needs to be given the result, or 
the command may not even be started. For a CMS type command (see Commands), it may mean that 
an intermediate I/O operation is complete. 

Waiting I/O implies that the task is executing a command on the drive, and that the command is cur- 
rently in progress. 

Idle is self-explanatory. 

Refer to figure 11-2 for a sample Task Information Entry and an explanation of the decoding. 



TASK INFORMATION 



56C3 


FFEB 5600 00 


56C8 


FF17 581B 58 


56C0 


FF43 5900 DO 


56D2 


FF6F 5A79 5A 


56D7 


019B 5B9F 5B 


56DC 


FFC7 5C00 00 


56E1 


FFF3 5D00 00 


56E6 


FF1F 5F00 00 



56C3 



Example of Decoding 
FFEB 5600 00 



IDLE-*- 



V 
BASE 



-^L REGISTER 



ADDRESS OF 
56EB 



Figure 11-2. Sample Task Information Entry 
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TASK STACKS 

The task stacks are 3(X)-byte entries, one per drive, and represent the call and return stack for the task. 
Each entry on the stack is a 2-byte reversed address which is used to transfer control to the routine 
pointed to by the address. Additionally, temporary data is put onto the stack for convenience purposes. 
The task information "L" register value points to the next available 2-byte task stack entry. All task 
stack entries are "POP"ed and "PUSH"ed in a first-in-last-out (FILO) manner. 

TASK STACK DATA FOR DISK PACK DEVICES 

The disk pack devices use the task stack for additional command parameters and data. The portion 
of a task stack used by a disk pack device is pointed to by the Drive Table for the disk pack device 
(see Drive Table, Disk Pack Devices, MY.L Field). The format of the Task Stack Pack Area is shown 
below. (Note: add the value of the MY.L field from the Drive Table to the "byte" offsets below to 
arrive at the memory address of the data.) 



Byte Length Mean 1 ng/Con+ents 

2 Buffer fragment length 

2 2 Buffer fragment page 

4 2 Buffer fragment base 

6 2 Total transfer size. Note: Drive Table buffer 

size = number of bytes transferred so far 

8 1 Block level transfer - HSTLTA block types 

currently expected. 

eBO§ = NSBR block expected 
840fl = NSBW block expected 
i20i = TD block expected, but not required 

9 1 Block level transfer - HSTLTA block types 

al lowed after a transfer delay occurs 
eot = NSBR block allowed 

m'*v9 * noon uik^«i\ a I iv/wvu 

10 2 Address of Read Transfer routine for this 
coRwiand 

12 2 Address of Write Transfer routine for this 
command 

Search Command Hit Sector address 
Search Command Hit Sector offset 
A copy of the original values of 
bytes through 13 to be restored 
to bytes through 13 If a retry Is 
required 



14 


4 


18 


2 


20 


14 



MANAGER STACK 

This is a 50-byte entry that contains run-time pointers and data for the Scheduler and Task Manager 
routines. The format of this structure is the same as for the task stacks. However, only the manager 
routines use it. 
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PORT TABLE 

The port table entries each describe a port on the DSM processor, 
elements, with the following format: 



The entries consist of 43-byte 



Byte 



Length 

1 


1 


1 



40 



Mean I ng/Contents 

Controller ID 

The 0-re I at I ve drive number of the first 

drive on the port 

The number of drives on the port. Note the 

following relationship: first drive plus 

number of drives = the first drive on the 

next port 

Control ler-dependent parameters 



CONTROLLER IDENTIFIERS 

The following values may be found in the Controller ID field of the Port Table: 



ID 


CONTROLLER TYPE 




DRIVE TYPE 


PORT ASSIGNMENT 


i52i 


Standard disk 
Host Control ler 




In drive 

Table 


Any port 


3 


thru 7 


i60« 


1 drive 
BSMD 


1MB 




89489-1/11 


Any port 


3 


thru 7 


«62« 


1 drive 
100 TPI 


cartridge 


disk 


B9 48 0-11 


Any port 


3 


thru 7 


i64t 


1 drive 
200 TPI 


cartridge 


disk 


B9 481-11 


Any port 


3 


thru 7 


866« 


1 drive 
100 TPI 


cartridge 


disk 


B9 48 0-21 


Any port 


3 


thru 7 


«6B« 


2 drive 
BSMD 


1MB 




B9 489-1 2 


Any port 


3 


thru 7 


«6A« 


2 drive 


cartridge 


disk 


B9 48 0-12 


Any port 


3 


thru 7 


«6C« 


2 drive 


cartridge 


disk 


B9 481-12 


Any port 


3 


thru 7 


b6E« 


2 drive 


cartridge 


disk 


B5 48 0-1 2 


Any port 


5 


thru 7 


86F« 


2011 fixed 




B949>18/57 


Any port 


3 thru 7 


6818 


DMTR 






N/A 


Port 2 






8888 


DFCM 






N/A 


Port 7 






8BA8 


DISK PACK DDP 




IN DRIVE 


Any port 


3 


thru 7 










TABLE 








8FE8 


OS PORT 






N/A 


Port 






8FF8 


N/A 






N/A 


Port 1, Not used 


8FF8 


N/A 






N/A 


Any port 
contain i 


that does not 
1 device 



CONTROLLER DEPENDENT PARAMETERS 

Some controller firmware routines keep port-dependent information in the Port Table. The firmware 
for host and disk pack devices use this area of the Port Table. The formats are as follows: 
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Host Device Port Table 

If the Port Table ID is @52@, the following information applies: 
Byte Length Mean? ng/Contents 



Current hardware command string length 
Current hardware command 
Current port relative drive 
Current sector address 
Current I/O length 



If byte 5 



For all commands: 



4 


1 


5 


1 


6 


1 


7 


4 


11 


2 


7 


) thei 
1 


8 


1 


9 


4 


13 


1 


14 


1 


15 


2 


17 


1 


18 


1 


19 


1 


20 


1 


21 


2 



Search NULL character 

Search type (greater than, less than, etc.) 

Search starting sector address 

Tag offset within first sector 

Search tag length 

Search I/O length 



Current port relative drive 
Port busy flag (FF = true, 00 = false) 
Prepare-To-Load (PTL) flag 
Power-On-Reset (POR) In progress flag 
Base address of the first drive table for 
the first drive on this port 



Disk Pack Port Table 

If the first byte of the port table entry is @8A@, the following information applies: 
Byte Length Meaning/Contents 



"AD" register setting for this port 
Complement of byte 4 
Current active port relative drive 
Address of status byte for this port 
(B93B7 status is reflected as "PMA") 
Subsystem Poll In Progress flag 
Drive states (drive to 7), 1 byte each 
i008 - Idle 

801 i = Queued, command ready to send 
iFF8 = In progress, B93B7 has the command 



4 


1 


5 


1 


6 


1 


7 


2 


9 


1 


10 


8 



COMMAND TABLE 

This area is used to store the command information fetched from the OS processor. Each entry of 
the table is 18 bytes, and is indexed by drive number. All disk processor commands and layout are 
described in the following paragraphs. A sample command table section is shown in figure 11-3. 
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Opcode 



COnilAND 


TABLE 


lENITRY 





LOHHAMD 


TABLE 


ENITRy 


1 


COHHAMD 


TABLE 


emrni 


Z 


tOHHAMO 


TABLE 


ENfTiiY 


i 


bONtlAMO 


TABLE 


emuR'Y 


n 


mUhkliO 


TABLE 


enhry 


5 


LUtlHANO 


TABLE 


ENITHjr 


6 


LOHHAND 


TABLE 


£NIRY 


7 



61A3 


OiiOO 


0000 


OOOU 


ooao 


0000 


OOOu 


OQJd 


OduO 


dOOd 


61B5 


UOOO 


0003 


aoao 


0000 


0000 


uOOO 


OOUO 


0000 


doOO 


61C7 


0000 


0000 


3000 


ouoo 


0000 


UOOd 


OOitO 


OOdO 


0000 


6109 


oojoo 


000 


0000 


OdOO 


UOOO 


0000 


OOOU 


OuOO 


OUOO 


61EB 


dljOO 


6000 


0^00 


GOOD 


ddOO 


BACl 


0200 


04FF 


ff-ff 


61F0 


0000 


1)000 


OOiJO 


0000 


OUOO 


oooo 


OOUO 


OUdO 


dOOO 


620F 


aobo 


0000 


0000 


0000 


UOOO 


UOOO 


0000 


OdUO 


UiiQO 


62<!1 


0000 


0000 


OOdO 


0000 


0000 


OOOu 


OOdO 


OudO 


OdOO 



Figure 11-3. Sample Command Table Section 

COMMAND RESULTS 

The results of a command are relayed to the OS processor in three ways: 1) through Command Status 
(see Drive Table), 2) through result descriptors (see Drive Table), and 3) through result parameters. 

The semantics of Command Status are explained in the Drive Table description. 

If a disk device error occurs, the error information is maintained in a result descriptor structure, and 
the unique result descriptor identifier is returned in the last three command parameters, bytes 16 
through 18. 

The result parameters are command dependent, and are returned to the OS processor in bytes 10 
through 15 of the command parameters. 

GENERAL COMMAND LAYOUT 

There are five types of system commands, as follows: 

1. Read. 

2. Write. 

3. Search. 

4. Initiahze. 

5. Lock/unlock door. 

Some commands have a specific format, but in general, they have the following format. Any deviations 
from the general format are identified in the individual command descriptions. 



Byte 



Length 



1 


1 


2 


2 


4 


2 


6 


2 


8 


2 



10 



Mean I ng/Contents 

Opcode 

Buffer fragment size 

Buffer fragment page 

Buffer fragment base 

Total buffer size: note the following 

relation: If buffer fragment size equals 

total buffer size, then the transfer Is not 

to/ from fragmented buffers, but contiguous 

meinory* 

Starting sector address. 
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There are two types of commands: System and CMS. System commands require no preliminary pro- 
cessing before being executed by disk drive controller firmware. CMS commands are commands that 
manipulate disk directory structures, and may be made up of many system commands (READ 
WRITE, and SEARCH). The commands are as follows: 



Opcode 



Type 



Description 



«00« 


SYS 


<01i 


SYS 


i02e 


SYS 


«03« 


SYS 


eo4i 


SYS 


i056 


Sts 


«06« 


SYS 


•076 


SYS 


«oei 


SYS 


«09« 


SYS 


eoAe 


SYS 


iOBi 


SYS 


«oc« 


SYS 


600« 


SYS 


iOE« 


SYS 


«OFi 


SYS 


810C 


SYS 


»]}% 


SYS 


«128 


SYS 


61 3t 


SYS 


6146 


CMS 


6156 


CMS 


6166 


CMS 


6176 


CMS 


6186 


CMS 


6196 


CMS 


61A6 


CMS 


61B6 


CMS 


61C6 


CMS 


6266 


CMS 


6276 


CMS 


628 6 


SYS 


6296 


SYS 


62A6 


SYS 



ReeKl Data 

Write Data 

Write Data and Check data or data parity 

Search less than tag argument 

Search less than tag argument and read 

hit sector 

Search Q-eater than tag argument 

Search greater than tag argument and read 

hit sector 

Search equal to tag argument 

Search equal to tag argument and read hit 

sector 

Search less than or equal to tag argument 

Search less than or equal to tag argument 

and read hit sector 

Search greater than or equal to tag 

argument 

Search greater than or equal to tag 

argument and read hit sector 

Initialize 

Lock Door 

Unlock Dbor 

Read Device Statistics 

Clear Device Statistics 

Read Result Descriptor 

Read Disk File Header (DFH) 

Write DFH 

Locate pseudo pack 

Locate f I le 

Locate file and read DFH 

Create temporary entry 

A I locate file area 

Crunch f I le 

Purge file 

Power off disk 

AVR disk with label read 

Initialize disk pack cylinder data 

Verify disk pack cylinder 

Relocate disk pack bad sector 



READ 

READ transfers data from a disk device to memory. READ uses the standard command format. 
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WRITE 

WRITE transfers data from memory to a disk device. WRITE uses the standard command format. 

WRITE WITH DATA OR DATA PARITY CHECK 

This command performs a WRITE operation, and then reads the data back from disk to check it. 
If the device is a 3/6 BSMD, then the data parity is checked. If the device is a cartridge disk device, 
then the data read back is compared to the data written. If the device is not one of these types, the 
command defaults to a normal write. This command uses the standard format. 

SEARCH 

The SEARCH commands search the disk for the occurrence of a tag with a given relationship to a 
tag argument. Search uses the standard command format with the following changes: 

Byte Length Meaning/Contents 

8 2 Number of sectors to search; two bytes, 

reversed 
10 3 Starting sector address 

13 1 Key length 

14 1 Key offset within tag argument 

15 1 Tag argument length 

Search returns the following result parameters: 

Byte Length Mean I ng/Contents 

10 3 Hit Sector address 

13 1 Offset of Hit Tag within the Hit Sector 

INITIALIZE 

INITIALIZE is vahd for cartridge type devices and disk pack devices. 

DISK CARTRIDGE DEVICES Initialize for disk pack devices causes sector 
addresses to be written to one cylinder of the 
device, and the sector data fields written with 
a data pattern. The command parameters are as 
fol lows: 

Byte Length Mean I ng/Contents 

8 2 Number of tracks to Initialize 
10 3 Starting sector address of starting track 

DISK PACK DEVICES Initialize for disk pack devices causes 
sector addresses to be written to one cylinder 
of the device, and the sector data fields 
written with a data pattern. The command 
parameters are as follows: 

Byte Length Meaning/Contents 

10 3 Starting sector address of cylinder 
13 2 Data pattern, 2 bytes reversed 
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LOCK DOOR 

This command causes the door of a 3/6 BSMD device to be locked. All command parameters are ig- 
nored except the OPCODE. 

UNLOCK DOOR 

This command causes the door of a 3/6 BSMD device to be unlocked. All command parameters are 
ignored except the OPCODE. 

READ RELOCATION MAP 

This command transfers the relocation map of host (SDHC) type devices to the buffer. This command 
uses the standard format. 

READ STATISTICS 

This command transfers the statistics of host (SDHC) type devices to the buffer. This command uses 
the standard format. 

CLEAR STATISTICS 

This command clears the statistics of host (SDHC) type devices. All command parameters are ignored 
except for the OPCODE. 

READ RESULT DESCRIPTOR 

This command finds the correct result descriptor and transfers it to the buffer. The command 
parameter format is as follows: 

Byte Length Mean t ng/Contents 

10 1 Result descriptor Identifier 

READ DFH 

This command returns an adjusted DFH to the OS processor buffer. The The command parameter 
format is as follows: 

Byte Length Mean I ng/Contents 

10 2 DFH directory Index 

WRITE DFH 

WRITE DFH writes the actual header to disk when given a directory index and an adjusted DFH in 
the buffer. The command parameters are the same as for READ DFH. 

LOCATE PSEUDO PACK 

LOCATE PSEUDO PACK searches the PPIT on a given unit for a 7-byte pack ID and returns the 
pack tag and logical unit number. The command parameters are the standard format. The resuh pa- 
rameters are as follows: 
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Byte Length Meaning/Contents 

10 1 Pack tag 

11 1 Logical unit number 



LOCATE FILE 

LOCATE FILE searches a Directory Name list for the 13-byte File ID in the buffer and returns the 
directory index of the DFH if the ID is found. The command parameters are the standard format. 
The result parameters are as follows: 

Byte Length Meaning/Contents 

10 2 DFH directory Index 

LOCATE HEADER 

LOCATE HEADER is identical to LOCATE FILE, except that a successful LOCATE will return an 
adjusted DFH. The command parameters are the standard format. The result parameters are the same 
as LOCATE FILE. 

CREATE TEMPORARY ENTRY 

CREATE TEMPORARY ENTRY searches the Name List for an available entry, updates the corre- 
sponding header entry, and returns the header and directory index if the disk had an available entry 
to use. The command parameters are the standard format. The result parameters are the same as LO- 
CATE FILE. 

ALLOCATE AREA 

ALLOCATE AREA allocates an area for the specified DFH. The command parameters are as follows: 



yte 


Length 


Meaning/Contents 


10 


2 


Directory Index 


12 


2 


Area size In sectors 


14 


1 


Area number 



The result parameters are as follows: 

Byte Length Meaning/Contents 

10 3 Starting sector address of area Just al located 

CRUNCH FILE 

CRUNCH FILE alters the specified DFH to return excess space to the non-file directory. If the last 
area is not on the specified unit, only the file pointers are updated. The command parameters are the 
same as for READ DFH. 

PURGE ENTRY 

PURGE ENTRY returns the specified directory entry to the available list, and returns all disk space 
allocated to the file on this disk to the non-file directory. The command parameters are the same as 
for READ DFH. 
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POWER OFF DISK 

This command causes the disk to be logically powered off. The following steps are taken: 

1. The door is unlocked (if applicable). 

2. The Label Integrity flag is reset. 

3. The tables for the drive are initialized. 

All command parameters are ignored except the OPCODE. 

AVR DISK 

This command performs the automatic volume recognition functions, such as label verification, setting 

the intPOritV flaO anH rpmnetmr'fir*?! Thf> ^.r.rr^rv^on/^ r^nr-nr^^tnr-^ „, — <-U. _t 1 1 e 4. 

cj — ./ oj --..^—wv* v»-wi.»v^**. » ».^ ^..^AAAAXAuiAu put MiiivLvi l3 cti V Lilt aidiiuaiu lUllilCll. 

INITIALIZE CYLINDER DATA FIELDS 

This command is valid for disk pack devices only. This command writes the sector data fields of the 
specified cylinder with the specified data pattern. The command parameters are the same as for the 
INITIALIZE command for disk pack devices. The result parameters are as follows: 

Byte Length Meaning/Contents 

13 3 Sector address where the first/worst error 

occurred (If an error occurred) 

VERIFY CYLINDER 

This command is valid for disk pack devices only. This command verifies the cyhnder data fields and 
error protectioncodes of the specified cylinder. The command and result parameters are the same as 
for INTlIALIZt: CYLINDER DATA FIELDS. 

RELOCATE BAD SECTOR 

This command is valid for disk pack devices only. This command causes the specified sector to be 
relocated to a spare on the cylinder. The command parameters are as follows: 

Byte Length Mean I ng/Contents 

10 3 Sector to be relocated 

13 2 Data pattern 

DRIVE TABLE 

The drive table holds all data relative to its corresponding drive. The drive table is divided into two 
parts: the general data area and the device-dependent data area. The general data area is standard 
among all drives. The device-dependent area is different for each of the three types of drives: disk 
cartridge, host, and pack. Each of the areas is described as follows. 
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DRIVE TABLE LAYOUT 

Byte Length 



1 




2 




3 




4 




5 




7 




8 




9 




10 




11 


2 


13 


15 


28 


210 



Mean I ng/Contents 

Drive Status (Refer to Table 11-1) 

Drive Identifier (Refer to Table 11-2) 

The Port for this Drive 

DFMC Participating Flag 

Command Entrance Routine Address 

Camand Status (Refer to Table 11-3) 

Monitor Status (Refer to Table 11-3) 

(kMmand Retry Count 

Result Descriptor Index 

Result Descriptor Size 

CoffliTiand Parameters (Refer to (kjmmand Table) 

Device- Dependent Data Area 



Table 11-1. Drive Status 



It 


Set Meaning 


Reset Meaning Note; 





Ready 


Not Ready 


1 


Write Inhibit 


Not Write Inhibit 


2 


Temporar 1 1 y 
Available (TNA) 


Not TNA * 


3 


Disk In Danger 


Disk Not In Danger 


4 


Disk Expiring 


Disk Not Expiring 


5 


Mandatory Interrupt 


Not Mandatory Interrupt 


6 


Spare 




7 


Spare 





•TNA applies to 3/6 devices only, and Implies that the door of the 
other drive Is open. 



Bits 2 through 5 are for SDHC devices only. 
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Table 11-2. Drive Identifiers 



antJfler 


Drive Type 


Drive Name 




Controller 


•53« 


B949>20 


20 MB 21 1 FD 




SDHC. 


K2i 


«54i 


B9 49 3-80 


80 ^e 211 FD 




SOHC, 


t52« 


«56« 


B9 489-2 1/23 


3/6 BSMD 2DR 




SOHC, 


t52« 


«57« 


B9 49 3-40 


40 te 211 FD 




SOHC, 


«52« 


e60« 


89 489-1/11 


1MB BSMD 10R 




SAME 




a62i 


89480-11 


100TP! CART 1 


OR 


SAME 




•64« 


B9481-11 


200TPI CART 1 


DR 


SAME 




«66« 


B9 481-21 


100TPI CART 1 


DR 


SAME 




«68i 


B9 489-1 2 


1MB BSMD 2 DR 




SAME 




e6A« 


B9 48 0-12 


CART 2 DRIVES 




SA^c 




«6C« 


B9 489-12 


CART 2 DRIVES 




SAME 




<6E6 


89480-22 


CART 2 DRIVES 




SAKE 




i6F« 


89483-18/37 


2011 FD 




SAME 




«F8« 




205 DPD 




OPIOC, 


ffiAi 


i78a 




206 DPD 




DP IOC, 


ffiA« 


a68« 




207 FD 




DP IOC, 


«Ai 



The drive IDs declare the type of drive present, and sometimes match the port controller ID (See Port 
Table). 



Table 11-3. Command Status Semantics 

COMMAND STATUS 



Value 

00 
01 
02 

03 
04 
05 



Meaning 

Controller error - Internal to DP 

Conrnand successful 

Ccmmand Incomplete, legal unsuccessful result 

(I.e., SEARCH tag not found) 

Device error - command aborted 

Spare 

I/O descriptor error 



MONITOR STATUS 



Value 

00 
01 
02 
03 
04 
05 
06 
07 
08 
09 



Mean I ng 

No error 

Seek timeout 

Head off cylinder (Seek error) 

Sequence error - Internal to DP 

Disk data/ address parity error 

Disk address not found 

Illegal address In I/O descriptor 

Status word error - Internal to DP 

Data error In COMPARE 

Attempt to write to write-lnhlblted disk 
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DEVICE DEPENDENT DATA AREA 

The byte offsets given here are a continuation of the offsets found in the general data area description. 
The values of some of the fields in the Drive Tables can be found in the discussion of the specific 
device type. 

Disk Cartridge 

The following table defines the remaps of the device-dependent data area for disk cartridge devices. 

Byte Length Mean I ng/Contents 

28 2 Pointer to the Next Phase routine 

30 2 Total buffer size 

32 2 Fragment size 

34 2 Fragment page 

36 2 Fragment base 

38 2 Least significant two bytes of the current 
sector address 

40 1 One Buffer flag 

41 1 Most significant byte of the current sector 

address 

42 1 Last Transfer flag 

43 1 Current retry count 

44 1 Dual 2011 flag 

45 1 Sectors per track 

46 1 Compliment of the "AD" register setting 

47 1 Current control ler status 

48 1 Opcode 

49 1 Drive address on the port 

50 1 Current Search size 

51 1 Current Search flags 

52 1 Current Search offset 

53 1 Current Search Hit Sector address 

54 2 Current cylinder number 



HOST DEVICES 



Byte 



Length 



28 


180 


208 


4 


212 


1 


213 


1 


214 


2 


216 


2 


218 


2 


220 


2 


222 


2 


224 


2 


226 


1 


227 


1 


228 


1 



Mean I ng/Contents 

Search Hit Sector buffer 

Search Hit address 

Search Hit offset 

Hardware opcode 

Fragment size 

Fragment page 

Fragment base 

Address of Command Complete routine for this 

command 

Address of Transfer routine for this command 

Transfer length 

211 type device flag 

One buffer flag 

Address of drive on port 
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Byte 



Length 



Mean I ng/Contents 



SDHC last status 

Last Class 2 Status Interrupt 

Error mask 

Hardware status, DC status bytes 1, 2 and 3 

Port Polling flag 

Drive status for Polling process 

If the Search Hit Sector buffer contains the device attribute record tD4R) then ^^^ f^n-^"-;"^ f;»Hs 
can be found in the DAR: ''niiuuic recoru ^uakj, men .... .^..v.,..x.5 ...i^s 



229 


1 


230 


1 


231 


1 


232 


4 


236 


1 


237 


1 



Byte Length Meaning/Contents 



as 


1 


OAR Check Byte 1 


29 


4 
1 


DAR Check Byte 2 


30 


1 


DAR Confidence Test resu 


31 


7 


Drive ID bytes 


38 


12 


DAR for Drive 


50 


12 


DAR for Drive 1 



DISK PACK DATA AREA 



Byte Length Meaning/Contents 



2B 


1 


29 


1 


30 


1 


31 


1 


32 


2 


34 


4 


3B 


4 


42 




43 




44 




45 




46 




47 




48 




50 




51 




52 


2 


54 


2 


56 


2 


58 


2 


60 


1 



ffiOi, Command Block Type byte 

iOC«, Command Block Count byte 

Current B93B7 Opcode 

Current B93B7-Relattve Unit 

Current command variants 

Current I/O length 

Current sector address 

«1«, Write Block Type Byte 

Write Block count byte 

Search Nul I Character 

Search Relationship 

Search Tag Offset within sector 

«00«, not used 

Reason for last transfer delay 

eOOi, not used 

Last short result descriptor Info byte 

Value of "L" register at command start 

MY.L, the current value of the "L" register 

Pointer to the Port Table of the port to 

which this drive Is connected 

Address of the current result descriptor 

for this drive 

Result descriptor Identifier 
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RESULT DESCRIPTORS 

There can be two result descriptor lists: AVAILABLE and INUSE. The AVAILABLE list contains all 
result descriptors not containing data, and the INUSE list has all the result descriptors containing data 
when the dump was taken. 

The INUSE list can be expected to have all result descriptors that are currently being used to store 
error information. Typically, this list is empty, as data from INUSE result dfS^"P5«"^^«/l'^,have been 
fetched by the OS processor, and the descriptors would have been returned to the AVAILABLE list. 

A result descriptor is divided into two parts: control information and data. The control information 
is used to maintain the result descriptor lists, and the data portion contains the drive-related failure 
data. 

CONTROL INFORMATION 

The format of the CONTROL INFORMATION is as follows: 
Name Byte Length Meaning/Contents 

LIMC 1 2 Link to the next RD on this list; •^FFF« 

Implies that the end of the list has been 
reached. 

INDEX 3 1 Index. This Is the unique RD Identifier. 

ORjVE 4 1 Drive. If the RD Is available, this field 

Is «FFfl; otherwise. It Is the drive number 
of the drive whose data Is In the RD. 

RD DATA 

The RD Data portion of a result descriptor contains the information describing the error, and the for- 
mat of the data depends upon the type of device that owns the RD. 



Disk Pack RD 



Byte Length Meaning/Contents 

1 1 B9387 Opcode 

2 1 B93B7 -relative unit number, 0-7 

3 2 B9387 command descriptor variants 
5 4 Starting sector address 

9 4 I/O operation length 

13 1 Last byte read from the B900 disk pack DDP 

14 1 Last byte expected to have been read from the 

DDP - see note 4 

15 1 DDP status after last byte read from OOP 

16 1 KOO error number - see note 1 

17 1 89367 longitudinal parity byte 

18 I Host-computed longitudinal parity byte 

19 1 Last CIO command sent - actual value 

20 1 Status response to last CIO command 
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21 1 Direction of transfer - see note 2 

22 1 B9387 long result descriptor byte 

23 1 B9387 long result descriptor byte 1 

24 44 B93B7 long result descriptor bytes 3-45 

Notes: 

1. 01 = Bod vertical parity error on B900 Input transfer 

02 = Bad longitudinal parity error on B900 Input transfer 

03 = OOP 2.0-second timer «<plred before B9387 response 

04 = Host block count different from B9387 block count 

on Input or output transfer 

05 = Software 2.3-second counter expired while waiting 

for B93B7 response; DOP timer failed 

06 = Incorrect Block Type en 3900 Input transfer 

07 * Count byte did not correspond to type byte on B900 

\npuf transfer 

2. 00 = From B900 OOP to B900 DSM processor 

01 = Froi 8900 DSM processor to B900 DDP to DSM processor 

3. This Is the actual Hex value sent to the DDP 

4. If the error number Is 06 (Bad Type Byte), then this field 
has the following meanings: 

01 = Expected TD, long RD, short RD, READ OK, READ retry, 

READ correction, or READ uncorrectable 

02 = Expected TD, long RD or short RD 

03 = Expected long RD or short RD 

04 = Expected TD during SEARCH 

NULL RESULT DESCRIPTORS 

A result descriptor is termed a "Null RD" when it contains error data, but the error occurred before 
a command was sent to the drive. An example of this is a mandatory interrupt on a 3/6 device, which 
occurs when the BSMD is placed in the drive and the door shut. In these cases, the status of the device 
changes from Not Ready to Not Ready-Mandatory Interrupt. In order for the OS to display the man- 
datory interrupt message with device status, the DSCP places the status in a NULL RD, and changes 
the device status in the OS. The OS sees the status change, and issues the READ RESULT command 
to the DSCP, with the unique result descriptor identifier parameter as @FF@ (hence, NULL). This 
causes the DSCP to return the correct RD. 

A NULL RD in the INUSE List is indicated by an index value greater than @E0@. 

DISK CARTRIDGE DRIVES DATA CONSTANTS 



isk cartridge constants are: 






Field Name 


Values 


Meanings 


Search Flags 


01 


Dual search required 




02 


Pattern search 


Control ier Status 


00 


Seek mode 




01 


Comnand node 




02 


Idle 
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HOST DATA CONSTANTS 



Host data constants are: 








Field Name 


Values 


Meanings 




Current Hardware CMD 


8A1i 


Read 






«CE« 


Write 






»mt 


Search 






8A2« 


Read search result 






eAoe 


Read relocation map 






8AE0 


Read statistics 






9M$ 


Read DAR 






8A78 


Read device status 






SFDt 


Abort command 






iFB8 


Clear Statistics 






eF2« 


Set Write Protect 






«F4« 


Reset Write Protect 






ecii 


Unlock door 






«C2« 


Lock door 






8C4« 


Reset MTR 




Control ler Status 


eoofl 


Idle 






601 e 


Pending 






eo2« 


Busy 




Error Mask 


6658 


Read After Write Check In 
progress, drive Write 
Inhibited 






«18 


Read After Write Check 
failed. Drive Write enabled 




B93B7 Opcode 


«016 


Read 






8028 


Write 






8038 


Search 






8108 


Initialize 






8118 


Verify 






8128 


Initialize Data Field 






8148 


Relocate Sector 






8208 


Test operation (soft poll) 






iB08 


Initialize C/W parameters 




Command Variants 


880008 


Watt for Seek to complete 






800008 


Do not wait for seek to 
comp 1 ete 




Search Relations 


8018 


Less than 






8028 


Equal to 






8038 


Less than or equal to 






8048 


Greater than 






8058 


Not equal to 






8068 


Greater than or equal to 




Task States 


8008 


Idle 






8FF8 


In process 






8018 


Queued 




Blocks Expected 


88 08 


NSBR expected 






8408 


NSBW expected 






8208 


TD expected 
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RECOMMENDED PROBLEM SOLVING PROCEDURES 

The Disk Processor can be involved in two types of system problems. These are a system hang and 
a @FO0OOO@ clearstart. What follows are some recommended procedures for determining if the prob- 
lem is due to a hardware failure or a software failure. 

System Hang 

If the system hangs such that the time-of-day is still displayed, and if the processor displays continue 
to cycle, and the SPO transmits but does not respond, then perform the following steps: 

1. Take a ROM dump and run ROMCONVERT and the SYS ANALYZER on the converted dump. 

2. Determine which disk is the system disk from the Configuration Table portion of the OS dump. 

3. Find the Drive Status field in the Drive Table for the system disk. 

4. If bit 1 of the drive status is set, meaning "Ready," then the hang is due to some other factor. 

5. If bit 1 of the drive status is reset, meaning "Not Ready," then the hang might be due to a 
not-ready system disk. 

6. If the system disk is a SDHC 211 type device, then the Last Status field of the Drive Table 
contains the status that caused the disk to go not ready. 

7. Additionally, check the Result Descriptor Inuse list to see if an RD belongs to the system disk. 
If so, then this RD might contain more information about what caused the system disk to go 
not ready. 

8. If the system disk is a B9387 DPDC disk pack device, then find the Port Table entry for the 
DPIOC. 

9. Locate the address of the Status Byte field in the Port Table. 

10. Find the byte having this address in the disk processor Hex dump. 

11. If this byte is @00@, the system disk was made Not Ready because the B9387 went off Hne 
for one of three reasons: 

1) Someone placed the B9387 off line at the B9387. 

2) A cabling problem exists that caused the off-line signal to change states (noise, cable fell off). 

3) The B9387 controlware detected a temperature warning condition and will power, or has pow- 
ered, itself off. 

FOOOOO Clearstart 

A @F00000@ clearstart may be caused by three things: 1) a real hardware failure; 2) corrupted buffer 
memory buffer addresses; 3) corrupted I/O descriptor buffer address. To determine which of these 
things occurred, perform the following steps: 

1. Take a ROM dump, run ROMCONVERT and SYSANALYZER on the dump. 

2. Locate the Disk Processor Save State Area. 
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3. If the IC error and status information indicate that a real error occurred, and MAX, MXA and 
MXB contain vahd bus/page data, then a real error did occur at the IC First Error Reg address. 

4. Otherwise, if MAX, MXA, MXB do not contain valid bus/page data, then the problem is a soft- 
ware error. 
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SECTION 12 

BUFFER MEMORY 

INTRODUCTION 

Buffer memory is a global system resource used for file buffers, system I/O descriptors, data comm 
buffers, and queues. The amount of buffer memory is specified in the dependent portion of the SYS- 
CONFIG file. 

1 uia dewiiuu liiM Qia^uaa^a LU^ itcnUi^u^ iui u&i&rniinin^ tn^ aliivjuixi. wi uunci opauc UCiiig aliOwatcu. 

This is followed by a detailed examination of the Buffer Memory section of a memory dump. 

The system uses the top page (or more) of OS memory as buffer memory. The system reserves buffer 
memory for the data comm buffers at WARMSTART. The amount reserved is that specified in SYS- 
CONFIG. The data comm buffers are analyzed and listed as part of the data comm section. No refer- 
ence is made to them here. 

The remainder is used as OS buffer memory. This must be at least 2048 (2K) bytes. Buffer memory 
can be a maximum of 1024 KB. 

Great care must be taken when assigning buffer memory. The performance of the B 900/CP 9500 can 
be seriously degraded if inappropriate values are specified in the buffer memory portion of SYSCON- 
FIG. If too much buffer memory is allocated for user programs, the MCP is forced to do more seg- 
ment overlaying. This is a result of not enough available MCP memory. If an insufficient amount of 
buffer memory is allotted for user programs, the programs will "wait on buffer space." 

I/O BUFFER SPACE CALCULATION 

There are three ways to determine the amount of required buffer memory. The first method is to ex- 
periment with different buffer allocations until an optimum system performance is attained. This is 
an inconvenient procedure and possibly inaccurate. 

The second method is to load the system with a mix of jobs that will reflect a maximum throughput 
condition required by the user. At this point, a memory dump should be taken using the "GT MD" 
intrinsic. Examine the "AVAILABLE COUNT" field found at the beginning of the buffer memory 
section in the dump. Multiply this value by 195 (the size of each buffer plus descriptors). Remember 
to byte-reverse and convert to decimal the value in the field before multiplying. This result will indicate 
the amount of available memory. Subtract the amount of available memory from the amount specified 
in SYSCONFIG. This is the amount of required buffer memory. It is advisable to add a safety factor 
of 2K to this amount. 

The third and most accurate method requires knowing the block sizes and the number of buffers 
needed for each opened file on the system. With this information, use the following procedure: 



1118478 12-1 



I/O BUFFER SPACE CALCULATION 
250 plus the following equation for Opened Files 

1> Number of buffers divided by 4 rounded up, plus 

2. Block size divided by 180 rounded up, times the number 
of buffers, plus 

3 . 1 If not I ndexed , or 

3 If Indexed file, times 

4. 195 

Example #1 - Indexed file, 6 buffers, block size = 270 

1. 6/4 = 1.5, r = 2 

2. 270/180 =1.5, r = 2, 2 x 6 = 12 

3. 3 

4. 2 + 12 + 3 = 17, 17 X 195 = 3315 bytes 

3315 
+250 

3565 I/O Buffer space for 1 opened file 

Example #2 - Non-Indexed file, 1 buffer, block size = 180 

1. 1/4 = .25, r = 1 

2. 180/180 = 1, r = 1 

3. 1 

4. 1 + 1 + 1=3, 3 X 195 = 285 bytes 

285 file 
+250 base 



535 bytes I/O space for 1 open file 

Example #3 - Both 1 and 2 opened 

3315 for file 1 
285 for file 3 
+250 base 

3650 bytes needed 
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OS buffer memory is organized in sections. Currently each section is 180 bytes in size (plus control 
fields). These sections are linked together in four categories: 

File table entries 

Key file table entries 

System I/O descriptors (Not yet implemented) 

Available sections 

These are controlled by a set of pointers located in the first 34 bytes of the buffer memory as follows: 

DA BUF POINTER POINTER 4 BYTES 

AVAI LABLE_HEAD 4 BYTES 

AVAILABLEJTAIL 4 BYTES 

FILE_TABLE_HEAD 4 BYTES 

FILE_TABLE_TAIL 4 BYTES 

KEY_FILE_TABLE_HEAD 4 BYTES 

KEY_FILE_TABLE_TAIL 4 BYTES 

SYSIO_DESC_HEAD 4 BYTES 

SYSIO_0ESC_TAIL 4 BYTES 

AVAILABLE COUNT 2 BYTES 



A sample of these entries in an actual memory dump is shown in figure 12-1. 



tAKititkii SUFFEk MEMORY »»•»»»»» 



DA BUF POINTEK POlNTEK U301 1860 

AVAILABLE HEAD 0401 616> 

AVAILABLE TAIL d301 1107 

FILE TABLE HEAD 0301 »^6b 

FILE TABLE TAIL OoOl OKBH 

KEY FILE Table rfEAJ FFFF FFFF 

KEY FILE TABLE TAIL FFFF FFFF 

SYS lU HEAJ 0301 ^OoJ 

SYo lU TAIL u301 3060 

AVAILABLE COUNT !>FdO 



Figure 12-1. Sample Initial Entry in Buffer Memory Section of a System Dump 



All but the Available Count are full system addresses, laid out as follows: 



7 7 7 15 

( ] t ] ( ] [ 

Page Bus Offset 



This layout is due to the byte reversal of the NBDS. 
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The exact usage ot these fields is as tollows: 



DA BUF_POINTER POINTER Contains the address of the start of OS Buffer 
memory. 



AVAILABLE HEAD 

AVAILABLE TAIL 

FILE TABLE HEAD 

FILE TABLE TAIL 

KEY FILE TABLE HEAD 

KEY FILE TABLE TAIL 

SYS 10 HEAD 
SYS 10 TAIL 
AVAILABLE COUNT 



Contains the address of the first 180-byte 
section In the chain of those sections that are 
available for use. 

Contains the address of the last available 
section. 

Contains the address of the first file table In 
the f I le table chain. 

Contains the address of the last file table In 
the f I le table chain. 

Contains the address of the first key file table 
In the key file table chain. 

Contains the address of the last key file table 
In the key file table chain. 

Not maintained. 

Not maintained. 

Contains the number of sections that are 
currently aval lable. 



SECTION LAYOUT 

Each section includes three parts: a preceding memory descriptor, the actual data, and a trailing de- 
scriptor: 



PRECEOINQ DESCRIPTOR 7 BYTES 



DATA 



TRAILING DESCRIPTOR 8 BYTES 



ISO BYTES 



ET2S52 



There are two links, a preceding link and a trailing link, because PIMOVE expects the link to immedi- 
ately precede the section and to point to the next link, while the I/O device controllers require the 
size of the next section and the Hnk to follow the section, and the link to point to the first byte of 
the next section (for performance reasons). A sample section of a memory dump containing this infor- 
mation is shown in figure 12-2. 
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FiLt TABLE E^I'SY (FTE> FLAGS SIZE LINK SIZE LINK AliORESS. FTE 

ul. Btoa di01A<4CB B400 0^015566 0^019^65 0000 



Figure 12-2. Memory Dump Sample Showing Section Layout 



PRECEDING MEMORY DESCRIPTOR FORMAT 

FLAGS : 1 byte 
SIZE : 2 by+es 
LirK : 4 bytes 

These fields are used as follows: 

FLAGS Defines the current use of this section: 

eoe : Available section 

toil : File table section 

•028 ; File table extension section 

<03« : Key file table section 

<04t : Key file table extension 

«05« : SYSIO descriptor table section 

«10« : Buffer section 



SIZE This entry contains the size of the section that 

follows. In this Impletmntatlon this field 
always equals 180. This field Is Implemented so 
that If the size of buffer sections change, code 
does not have to change. 

LIfK This entry contains the address of the preceding 

descriptor for the next structure of a similar 
type, except for buffer sections where this link 
points to the next link In the preceding 
descriptor of the next section of the buffer. 
The degree of linking varies according to the 
section type and use. A 1 1 sections reserved for 
buffers are not linked together. Only those 
sections associated with a particular buffer are 
linked. Conversely, all file table sections, 
key table sections, available sections, and 
system I/O descriptor sections are linked 
together. All file table extension sections 
belonging to the same file table are linked 
together. The link entry of the last section of 
any chain contains SFFFFFFFFi. 
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TRAILING MEMORY DESCRIPTOR FORMAT 

The trailing descriptor consists of three fields. These are as follows: 

SIZE: 2 bytes 

LINK: 4 bytes 

FTE (VALIDATION): 2 bytes 



SIZE This entry contains the size of the next section 

of the file table or the particular buffer. If 
the preceding section Is the last section of the 
file table or the buffer, this entry contains 
«FFFF«. 

L|M< For buffer sections, the link entry In the 

trailing memory descriptor Is used to address 
the first byte of the next section of that 
particular buffer. The link entry of the last 
section for that particular buffer contains 
eFFFFFFFFS. 

For file table sections, this entry points to 
the preceding descriptor of the file table 
extension section associated with the file 
table. If no file table extension section exists 
for this file table, this entry contains 
iFFFFFFFFi. 

For file table extension sections, this entry 
addresses the preceding descriptor of the next 
file table extension section for the file table. 
This entry In the last file table extension 
section for the file table contains SFFFFFFFFt. 

For all other section types, this entry 
addresses the preceding descriptor of the n«<t 

ea^+trtn n4 +Ka e am^ +\/r\^_ Thai l»e+ eo/*+Inn r»*f g 

particular type contains SFFFFFFFFi. 



ANALYZER LISTING 

The analyzer hsts the descriptor fields in a standard manner for all sections. This layout consists of 
one line of titled information comprising the flag field, the preceding descriptor information, the trail- 
ing descriptor information, the address of the section, and the vahdation field. 

FILE TABLE STRUCTURE 

File table information is kept in two structures, the file table and the file table extension. 

A file table entry is built when a CMS data file is first opened and it is maintained until a close reduces 
the user count to zero. Each file table entry (FTE) has one or more file table extensions linked to it. 
Each extension has four entries (FTEE). Each entry is a buffer descriptor that points to and controls 
a data buffer. 
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The exact layouts are described in the following subsections. 

FILE TABLE ENTRY 

A file table entry section contains the following information: 



DA FILE TAG 



COMMON EOF 



TOTAL DESC 



NIM USERS 



SHARED RECORD SIZE 



SHARED BLOCK SIZE 



AREA IhFORMATION 



This 4-byte field Is an Internal Identifier for 
the file. 

This >byte field holds the shared EOF for all 
users. 

This 1-byte field holds the number of 
descriptors allocated. 

The nufflber of users of th**" *''**, 

This 2-byte field holds the common record size 
for shared file users. 

This 2-byte field holds the common block size 
for shared file users. 

There are 16 entries, one for each possible area 
(disk only). Each entry Includes the following: 



UNIT 1 byte 
ADDRESS 3 bytes 
SIZE 3 bytes 



The DA_CT Index of the device 

Disk address 

Number of blocks In this area 



FILLER 



55 bytes reserved for future use. 



FILE TABLE EXTENSION ENTRY 

Each file table extension contains up to four buffer descriptors. The FTEE includes: 



Map 



Buffer Descriptors 



These four 1-byte fields contain the task IDs of 
the owners of these descriptors. If a 
descriptor Is unasslgned, the corresponding byte 
will be SFFfl. The first byte refers to the 
first descriptor, etc. 

These are 40 bytes each, and are described In 
detail In the next subsection. 



A sample from an actual memory dump is shown in figure 12-3. 

BUFFER DESCRIPTOR FORMAT 

Each buffer descriptor is laid out and analyzed as follows: 
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Descriptor 
Block ID 

FIB ID 

Lock 

Flags 



Unit No 

Queue Status 

Action ID 

Return Status 

Forward Link, 
Backward Link 

Opcode 

Buffer Address 



Size Parameter 



This nuntoer Is developed by the analyzer. 

This >byte field contains the block number In 
the file of the Information In this buffer. 

The first byte Is the FIB ID, the second the 

owner. 

Contains the ID of the owner of the block when 
It Is locked. If It Is SFFFFfl, the block Is not 
I ocked . 

These define the state of the buffer as follows: 

MSB 7 : Buffer allocated 

6 : Move outstanding 

5 : Shared buffer 

4 : Buffered ahead 

3 : Waiting 

2 : Updated 

1 : FV Inter backup 

LSB : Record outstanding 

Unit number for this I/O (Index Into DA_CT). 

Status of descriptor in queue (see PHT section). 

Action ID of requestor If waiting. 

The I/O status (see PHT section). 

Links for queuelng. These are I/O descriptors. 
They are two-way links for possible future use. 
Presently, everything Is linked In the forward 
direction. 

Operation requested. (See PHT section for 
normal operations, and Command Table section for 
specialized disk operations). 

Address of first section of buffer: 

Size 2 bytes 
Bus & page 2 bytes 
Address 2 bytes 

Total size of buffer In bytes. 



Device Dependent Parameters 

Device-dependent parameters, 9 bytes. 

Note that the address In l/O.DESC ■ «FFFF« If no buffer exists. 
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FiLE lABLfc, EXIENBiON ENTRY (FIEEJ 



P4ECEEl>IN£ 
FLAGS SIZ£ LINK 

J2 dHOO FFFFFFFF 



THAlLiMB 
SUE LINK 



a-tOO FFFFFFFF 0^01%366 



HAP FIE FTEE 

Aim ««» «««• 

OOOblOFF 0000 0000 



UESCRIPIOM 


ai 




BLOCK ID 


BjOO 


UO 


FIB 10 


1«!05 




LOCK 


FFFF 




FLABa 


SO 




UNIT NUiBER 


O* 




OUEUE STATUS 


ai 




ACTION 10 


OF 




KETUi<N STATUS 


dlOO 


uo 


FOfiuAiiD LINK 


0^01 


b377 


ciACKUARu LinK 


UUOl 


CAmA 


OP CODE 


<JU 




BUFFER ADDRESS 


BIOO 


11301 


SIZE PARAMETER 


8400 




DEKICE DEPENDENT PARAMETERS 


UUIO 


3102 




ALLOCATED 




NOT IN USI 



COMPLETE AND DEOUEUED 
CUMHANQ COMPLETE NO EHiiOR 

READ 



0004 0009 UO 



UNCONDITIONAL I/O 
NOT UPDATED 



NOT SHARED 

NOT PittNT BACKUP 



HOT BUFFEMED AHEAD: 
HOT OurSTAaDIHB 



PRECEEDINi. 
FLAGS SiyF I INK 

■ HHIItt HllMtt aMM* 

10 BIOS FFFFFFFF 



TkAILINO 
i>I7F I INK 

■ ••■ ■■•« 
BIOO FFFFFFFF 



a3bllF67 



DATA 



0»2E 3<l<til 69it<<: »t>A» 4A4C 414E 4/33 4147 4b20 5459 5045 2048 4153 2054 <IF4F 2040 

m4E 3924 4349 4152 4143 5445 5253 434E 4420 FFCO FFAU 2056 4652 4220 (SHE 5452 

4945 332J 5550 4441 3445 4454 4849 3320 4954 454D 2043 414E 4E4F 5420 4245 2054 

5<!41 4E5j 4C41 5445 444D 4953 204J 4134 434a 2046 4F55 4EH4 2049 4E20 4E45 572* 

3445 5^54 3245 434F 3645 3259 2043 4F4D 5040 4554 4544 FFCO 2057 4F52 1B20 4S47 

4C45 ca4C 4F41 4445 4453 542il FFCO 494E 5320 2000 



Figure 12-3. Sample File Table Extension Entry 



KEY FILE TABLE FORMAT 



KFILETAG 


4 bytes 


NUM USERS 


1 byte 


MAXJCEYFILE SIZE 


3 bytes 


KEYJiZE 


1 byte 


KEYJWTRY SIZE 


1 byte 


AREAJNFO 




Address 


3 bytes 


Length 


2 bytes 


INDX_REG EXISTS 


1 byte 


OVRFLW REG EXISTS 


1 byte 


RUF_TBLE 


10 bytes 


INDX_REG 


10 bytes 


OVRFLW REG 


10 bytes 


HIGHEST RECORD 




Area 


1 byte 


Sector 


3 bytes 


Offset 


1 byte 


Key 




SPARE 


25 bytes 


KEYFILE_REG_FRMT 




Start ( ng 




Sector 


3 bytes 


Size 


3 bytes 


Starting Area 


1 byte 


Distance to 




End Area 


3 bytes 
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Unique Identifier for file 

t of users with keyftle open 

Write EOF 

Actual size of key 

Key size reserved (5,13,21,29) 

Array [161 of record 



Set If Index region exists 
Set If overflow region exists 
See KEYFILE_REG_FRMT below 
See KEYFILE_REG_FRMT below 
See KEYFILE_REG_FRMT below 
Read EOF 



(offset In the sector) 
Array 128) of byte 
(last key value end) 

Record 



Number of sectors In starting area 



Starting sector In starting area 
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KEY FILE EXTENSION FORMAT 



Keyflle 



User 




2 bytes 


Updated 




1 byte 


Lock 




1 byte 


End List 




1 byte 


List Waiting 


Lock 




Action ID 




1 byte 


Take Lock 




1 byte 


Spare 




143 bytes 



Array 17 1 of record 

FIB_ID and TIO 

Flag for this user 

TID of next user (begin of list) 

Next available slot In lock list 

Array [71 of record 



SYSIO DESCRIPTOR TABLE FORMAT 

Not Maintained in 3,04 releases. 



AVAILABLE TABLE 

Lists available buffer space. 
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APPENDIX A 
OS ERROR INDICATORS 
BANKS C AND D 

The display on these control panel banks is an indication of processor business (normally a communi- 
cate count). 

CLEARSTARTS 

When the operating system encounters an error condition, it performs an error-handling routine which 
terminates with a clearstart. This causes a 3-byte field to be displayed on the hex display and on the 
ODT if its data path is still runable. The three bytes displayed are: 

BANK E -Error number as described below. 

BANK F -Index into the AM.ACTION.LIST for the action in error. 

BANK G -Id of the action in error. 

BANK E -CLEARSTART NUMBERS 

iOOt DEADLOCK ERROR - An action Is attempting to get on a 
queue behind Its parent which Is waiting for It to 
finish. 

iOlg NO NU^eERS error - a normal action was Invoked when 
there were already one hundred normal actions In the 
mix, and Activity Management could not assign It a 
unique ID; only 100 ACTION numbers are available. 

«02« BAD ACTION ID ERROR - A non-exIstIng action was 
Invoked. 

i03« BAD SEG ID ERROR - An attempt to access a non-ex I sting 
segment (work block, link block, data block, or code 
block) occurred. 

•04« TOO MANY WB ERROR - An action tried to get a work block 
when It already had four. 

«05t CALL FROM FS ERROR - An action called an Activity 
Management routine from force state which Is not 
allowed In force state. 

«06« CALL BY CONT ERROR - A continuous action called an 
Activity Management routine which Is not allowed for 
continuous actions. 

t07f CALL NOT NORM ERROR - An action attempted to get on a 
queue when It was already on a queue. 

«Oei WB AT FINISH ERROR - An action attempted to finish when 
It still owned a work block. 
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C09t BAD POST ERROR - An action cal led "POST-RESULT" passing 
an action ID of a non-exIstIng action, or of one which 
Is not awaiting a post. 

60A6 BAD DEQUEUE ERRva^ ~ nu aci lOn Si lefiipiSu lO uO^^^^^ iro??! 
a queue where It was not present. 

•OSa BAD STOP INT ERROR - An action called "STOP- I NTERRUPTS" 
when It was not proccessing Interrupts (not In force 
state). 

«OCi BAD AWAIT INT ERROR - An action called "AWAIT- 
INTERRUPT," specifying a channel which was being 
serviced already by some other action. 

•ODi ZERO DIVIDE ERROR - An action called "ABS.DIVIDE" 
passing a zero divisor. 

80E« PARITY ERROR - A parity error was detected by the OS 
processor. The State Save of a 2-MHz machine wl 1 1 have 
the address of the offending memory location listed 
under "IC - First Error Register" In the dump. 

aOF« BAD CLEAR ERROR - Software sent micro execution to 
address zero on any page. 

«10« PREV MARKED ERROR - An attempt was made to mark a work 
or link block with the state which It was already In 
(Jelled, frozen, unjet led, or unfrozen). 

flili MARK COUNT ERROR - An attempt was made to freeze or 
Jell a code or data block which already had 15 
outstanding freezes or Jells against It. 

«12« MEM CORRUPT ERROR - A virtual memory descriptor has 
been corrupted. 

•13t BAD CHANNEL ERROR - A call to "AWAIT- INTERRUPT" or 
"STOP-INTERRUPTS" was made which specified an Illegal 
channel number. 

cut STK OVERFLOW ERROR - An action called Activity 
Management with Its stack pointer pointing beyond Its 
al located space. 

•151 CONT VM ERROR - A continuous action required virtual 
memory for any reason. 

«16« BAD ENQUEUE ERROR - An action attempted to enqueue to a 
non-ex I sting queue. 

1171 C8 FREEZE ERROR - An attempt was made to freeze a Code 
Block. 

a 18 8 VM REQUEST ERROR - The function which virtual memory 
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was requested to perform does not exist. 

8198 VM LOCATE ERROR - The Work Block or Link Block which 
virtual mernory was requested to load In memory does not 
exist* 

•IAS VM 10 ERROR - An I/O error was reported In an attempt 
to read/write to the MCP f 1 le. 

The exact error and the sector In error can be found as 
fol tows: 

Deterwlne the action running In the OS 
(AM .ACT ION. LI ST). The action should be AM_VM. The comm 
field can be decoded as follows: 

Drive number Byte 1 

MTR status Bytes 2-3 

Sector address Bytes 4-6 

Unused Bytes 7-9 

Retries Byte 10 

Drive number Is as In disk processor, where Is A, 1 

Is B, , 7 Is H. MTR status Is defined In the Disk 

Management section of this manual (section 11). 

The same Information exists In the disk processor 
memory. If necessary, It can be decoded. 

The normal recovery action Is to utilize a different 
system disk to warmstart from, then take appropriate 
action with the falling disk, depending on the nature 
of the failure. FE assistance may be required. 

81B8 NO AVAIL MEM ERROR - Sufficient available memory cannot 
be obtained to satisfy the virtual memory request due 
to the number of Jel led or frozen memory blocks. 

81C8 COMPACT VMFIL ERROR - Virtual memory was unable to 
relocate a work or link block within the Backing Store 
portion of the MCP file. 

81D8 OS VMFIL FULL ERROR - The Backing Store portion of the 
MCP file Is completely filled. 

tlE« COMPACT MEM ERROR - Virtual memory was unable to create 
a block of contiguous available space of sufficient 
size to satisfy the request, due to the presence of 
frozen memory blocks. 

IIFi BAD BLK TYPE ERROR - An unrecognizable block type was 
encountered by virtual memory In the process of 
compacting memory. 

8208 WARMSTART ERROR - An error encountered by the Data 
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Access activity of the operating system during the 
startup process. 



«21i SYSOONFIG ERROR - An error was encountered while trying 
to access the SYSCONFIG file. An open or read error 
results In this error. 

8228 POWER OFF ERROR - A cal I to SYSTEMJRROR was made to 
stop the system because a Power Off command was 
received rather than because of an error. No error 
display Is made. 

8238 ATTACH BLOCK ERROR - An action attempted to attach a 

non-existent structure, attach a structure with one 

already attached, or locate a data block with one 
already attached. 

8248 DETACH BLOCK ERROR - An action attempted to detach a 
structure that was not attached. 

8258 INTRANSIT ERROR - Virtual memory cannot locate a 
section of memory It Just allocated. 

8260 MEMORY LIMIT ERROR - The hardware detected that the 
processor attempted to address a memory (RAM or ROM) 
that Is not In the system; often Indicates a disk drive 
and/or media problem. 

8278 BOUNDARY ERROR - The hardware detected that the 
processor tried to access the IC memory map when It did 
not Intend to, or that the processor tried to Increment 
through address eFFFFS on any page. 

82B0 FILE TYPE ERROR - This error Is generated when the Data 
Access activity, SYS_OPEN, Is requested to open a file 
that Is not a system file. 

8298 NO SIZE VMFL ERROR - This error Is generated when an 
attempt Is made to open a VM file which has a file size 
of zero. 

82 A8 VMFL IS OPEN ERROR - This error Is generated when an 
attempt Is made to open a VM file which Is already 
open. 

8286 SYSFL OPEN ERROR - This error is generated when an 
attempt Is made to open a system file which has a file 
type other than SYSTEM, LOG, CODE, or INTERPRETER, 
which Is already open. 

82Ce NAMTAB OV^R ERROR - This error Is generated when an 
attempt Is made to open a system file with the maximum 
number of files already opened for that file type. 

8208 Reserved. 
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82Ei ILLEGAL WRITE ERROR - This error Is generated when an 
attempt is made to perform a SYS-iO write to a file 
that is not opened with a usage of read/ write. 

«2FI INVALID OP ERROR - This error Is generated when an 
attempt Is made to perform a SYS-IO operation with an 
opcode other than read, write, or search. 

«30i Reserved . 

•3ie CLOSE ADV ERROR - This error Is generated when a SYS- 
CLOSE with purge of a file with type other than 
miscellaneous, list, NDLSYS, or VM-FILE is attempted. 

i32« NOT VMFILE ERROR - This error is generated when an 
attempt Is made to add an area to a system file other 
than a VM file, or to dump to a file other than a VM 
file. 

•33S ADD ZERO SIZE ERROR - This error is generated when an 
attempt Is made to add an area of size zero to a VM 
file. 

•348 QUEUE MAIMT ERROR - This error is generated if an 
illegal descriptor was sent to a physical I/O module, 
or If an Invalid unit number was detected. 

fl35fl 10 DESC ERROR - This error is generated if the I/O 
handler sent an illegal descriptor. 

836f Reserved. 

8378 DA PHT OVER ERROR - This error is generated when there 
are more than 20 devices on the system. 

838 8 KEYFILE FRMT ERROR - An error was encountered in 
accessing the Iteyflle (of an Index pair) that could 
only occur as a result of the keyflle being formatted 
incorrectly. 

8398 DA OUTCX)ME ERROR - This error Is generated when an 
unrecognized output from the I/O subsystem Is received. 

83A8 DA BUFF »CM ERROR - This error Is generated when an 
internal data access error Is detected during a buffer 
memory operation. 

83B8 DA SCL ERROR - This error is generated when an 
unrecognized output from a utility or the I/O subsystem 
procedure is received. 

83Ce Reserved 

8308 Reserved . 
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f3E8 START 01 ERROR - A problem has cxcurred In "START-OI" 
(operator Interface); probably a bad outcome In trying 
to access a system file (SYSMCP, SYSCONFIG, 
SYSLANGUAGE). 



i3F8 


Reserved . 


8408 


Reserved. 


8418 


Reserrved 


8428 


Reserved. 


8438 


Reserved . 


8448 


Reserved. 


8458 


Reserved . 


8468 


JM START 



JM START OPEN ERROR - An Interpreter file open has 
failed. 

8478 JM START TP ERROR - The load of an Interpreter to a 
task processor has failed. 

8488 JM STA»RT READ ERROR - A read from an Interpreter file 
has fal led. 

8498 JM OPEN PROG ERROR - Open of a program file has 
resulted In the return of on unexpected failure value. 

84A8 JM OPEN INTRP ERROR - Open of an Interpreter file has 
resulted In an unexpected outcome value for failure. 

•4Bi JM OPEN VM ERROR - Open of a VM file has resulted In an 
unexpected failure value being returned. 

A AAA u. n.ii(»r PDa/^ — TWa *a*i1>a 4 I sMa 4«si* * IaK Kalnn nAlieAH 

do not make sense. 

•4D8 JM TP ERROR - The task ID or mix number given by the 
Invoker of the task procesor error action Is Illegal, 
or a request made of a task processor has been rejected 
by It. 

84E8 JM ACCESS ERROR - Information passed to the MIX-ACCESS 
action Is Invalid (In all cases, the task Id). 

84Fe JM MX NAME ERROR - Information used to get a task name 
from DA (through DA.NAME.FIBID) gave a bad result. 
Error could be In JM or DA software. 

8508 Reserved. 

i518 JM ST ERROR - This error Is detected by the STOP action 
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Indicating that a specified Job is In an Invalid state. 

fl52i JM SUPER ERROR - A startup time detected error 
Indicating that the Initial load of SYSSUPERUTIL was 
unsuccessful* 

i53« JM DSDPFLA6S ERROR - A Job being DS-ed or DP-ed has the 
state flags In disarray. 

•54« JM EOJ ERROR - The end of Job code has been entered for 
8 Job whose state flags make no sense. 

«55« JM TERMFLAG ERROR - The terminate flag was set with no 
terminate condition existing. 

•56< Reserved. 

•57 « JM DCJOBREM ERROR - The DC Job removed action has been 
called for a Job whose flags say It Is not terminating. 

fl5B« JM JOBRUN ERROR - A TP has notified the OS that a newly 
loaded Job Is running when no such notification was 
expected. 

#59 « Reserved. 

•5At JM SELECT ERROR - The processor selected for the load 
of a Job has failed for unexpected reasons. 

•5B< JM TASK ID ERROR - A tasK processor sent a task ID to 
the OS that does not exist. 

9SCI JM SYSCQNFIS 10 ERROR - An !0 error occurred while JM 
was accessing the SYS00NFI6 file during warmstart. 

•5DI Reserved. 

flSEI Reserved . 

•64« DC RWL ERROR - The DCA (Data Conm Activity) attempted 
to access one of the queues, but was stopped because 
the READ-WITH-LOCK flag was set. 

•65t DC 101 Error - The result function has found an Invalid 
message type on the system result queue. This problem 
could be caused by running with an Incompatible version 
of MCP- and NPC- generated code files. 

I66S Reserved. 

e6Ei PI PROCESSOR ERROR - An attempt was made to send a 
message to an Illegal bus address ( XI5, for example). 

i6Fi PI TP TASK ID ERROR - The TP was asked to do something 
for a task that Is not running on that IP. 
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fl70i MOVE RESULT ERROR - An unidentified result was returned 
from PI MOVE by the TP. 



•718 


Reserved 


87 2i 


Reserved 


8788 


Reserved 


8798 


Reserved 


8968 


BAD DFH 1 



BAD DFH LOCK ERR - OPEN or aOSE attempted to read a 
disk file header without having acquired the disk file 
header lock. 

8978 ZERO ALLOC ERR - The system attempted to al locate a 0- 
slzed area on disk. 

8988 BAD ALLOC ERR - The system attempted to al locate an 
area with an area number greater than 16. 

8998 BAD INDEX ERR - The system attempted to access a disk 
file header with a directory Index greater than 2B05. 

89 A8 Reserved. 

89B8 BAD DFH ERR - The system attempted to write a disk file 
header with an Improper value In the FLAGS or EOF 
field. 

8908 BAD PACK TAG ERR - A PPIT search operation returned an 
Invalid pack tag to the system. 

8088 Reserved. 

8F0e DISK PROC ERROR - The disk processor detected an error. 
To determine the reason for the error, a ROM dump must 

t^A -i-^an »nM »n»l\frAA ^ TKo <^ Mwo Ataa of the diimo 

contains the IC Status which will Indicate the type of 
error. Figure 8-1 of this manual should be helpful. 

SFIt SUZIP FAIL ERR - On an unattended system, the program 
to be zipped at system startup time encountered a Load 
fal lure. The fol lowing two bytes of the display give 
the FCM value for the zip failure. 
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APPENDIX B 
TASK PROCESSOR SAVE ERRORS 

The task processor error numbers defined below are reported as the "Error Number" in a processor 
entry of the error log or in the dump's State Save Area for a task processor. 



aOOi Hardware detected error. 

flOie FS YIELD PRX - Force state has been detected while 
entering PM function YIELD PROCESSOR. This function 
should not gain control while In force state. 

«02fl ILL CALL AP - Two actions are allowed to call PM 
function ASSIGN PRIORITY; these are JC INTERP ACTION 
and JC COMMAND HANDLER. These errors Indicate the 
cal ler was neither. 

«03« FS ASG PRIOR - Force state has been detected while 
entering PM function ASSIGN PRIORITY. This function 
can not gain control while In force state. 

«04i FS INVOKE - Force state has been detected while 
entering PM function INVOKE. This function can not 
gain control while In force state. 

«05« FS FINISH - Force state has been detected while 
entering PM function FINISHED. This function can not 
gain control while In force state. 

ar\^a rIMICU f\U <-> _ DM CIMICUCn V,^,- k<>^n \nxml,s>A +n ^-ako sa 

status block (SB) off the linked lists; but the SB can 
not be located. Assune that the SB Is sti I I on a queue 
which Is In error. 

e07« Reserved 

8088 Reserved 

8098 ENO ILL Q - An Invalid queue name has been passed to PM 
function ENQUEUE. 

8108 Reserved 

8118 DEO ILL - An Invalid queue name has been passed to PM 
function DEQUEUE. 

8128 ILL POST - A PM POST has been Invoked on a SB that does 
not have a status of WAITING POST. 

8138 DEQ NOT HEAD - A SB has Invoked DEQUEUE to get off a 
queue while It Is not at the head of the queue. 
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8148 FS PRE POST - Force state has been detected while 
entering PM function PRE POST CALLER. This function 
cannot gain control while In force state. 

•158 FS MEMSPACE - Force state has been detected while 
entering PM function MEM SPACE. This function cannot 
gain control while In force state. 

•168 FS MARK - Force state has been detected while entering 
PM function MARK. This function cannot gain control 
while In force state. 

8178 MEM SP NO WB - A JC or PI action has cal led MEM SPACE 
to al locate a WB when the maximum limit of four has 
already been allocated. 

8188 FS FREE SPACE - Force state has been detected while 
entering PM function FREE SPACE. This function cannot 
gain control while In force state. 

8198 ILL FREE SPACE - A SB has called FREE SPACE to 
deal locate a structure, and FIND WB was unsuccessful In 
locating the structure. 

81E8 TASK LIMIT EXCEEDED - More than the legal amount of 
tasks allowed In the mix have been Invoked. 

8208 FS LINK WB - Force state has been detected while 
entering PM function LIfK WB. This function cannot 
gain control while In force state. 

8218 ILL INVOKE - An action has been called by INVOKE, but 
the action name does not exist (Is out of bounds). 

8228 MARK CODE SEG - MARK has been called to modify a 
structure of type SCODE. Only VM Is authorized to do 
this. 

8238 INVOKE VM - VM has been cal led by INVOKE; VM cannot be 
Invoked. 

8248 I NV TOO MANY ACT - An action being Invoked Is non- 

crltlcal; yet, due to lack of space In the SB ADDR 

ARRAY, It has overflowed Into the area reserved for 
critical actions. 

8258 AP NOT ON LIST - A search of the list heads by the 
action ASSIGN PRIORITY was unsuccessful In locating the 
SB of the task. 

8268 DEALLOC TYPE - Work block being deallocated was neither 
type Normal, SB, ICB, TCB, or PCB. Invalid use of 
DEALLOCATE. 

8278 ILL TRANSFER WB - TRANSFER WB was called to give up 
B-2 



ownership of a WB,but was not successful In locating 
It. 

«2B« ILL LIMC WB - LIM< WB was cal led to delink a WB and 
relink It, but WB was not found. 

a 296 Reserved 

«30« WB NOT FOUND - FlhD WB has not found a specified WB, 
and the error flag was on. In some cases, not finding 
a WB Is not an error, but It Is In this case. 

6318 FS LOCATE SSEG - Force state has been detected while 
entering PM function LOCATE SSEG. This function cannot 
gain control while In force state. 



8328 



ILLEGAL JOB COMMAND - The OS processor has requested 
the TP to perform an Invalid Job command. 



6338 ILLEGAL IN REQ - The OS requested an Invalid function 
of the task processor. 

8346 IMTERPRETER NOT LOADED - The OS requested the task 
processor to run a task for which there Is no 
Interpreter. 

6356 ILL MARK REQ - MARK has been cal led In order to mark a 
WB, but F\UD WB was not able to locate the WB. 

6368 FS GET SEGS - Force state has been detected while 
entering PM function GET SEGS. This function cannot 
gain control while In force state. 

8376 WS FATAL - No entry In the warmstart table (planted at 
startup time) has been found for this task processor 
during START m. 

6338 INV ILL INT TASK - An Interpreter action has been 
detected having an Illegal action ID. This means the 
ID Is not In the range of SB ADDR SLOTS set aside for 
INTERP ACTIONS. (INVOKE) 

6398 MARK DATA SEG - MARK has been cal led to modify an s- 
data type structure. Only VM Is authorized to do this. 

6X6 GET SEGS MANY - An Interpreter requested an Invalid 
number of segments (0 or more than 3) or requested more 
than one code segment. 

8306 GET SEGS KIND - The Interpreter requested an Invalid 
type of segment (not a data or a code segment). 

63Ee INVALID INTERPRETER NEED - The Interpreter requested an 
Invalid NEED. Valid NEEDs are: Communicate, Get 
Segment, Yield, Program Error, or System Message. 
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•40« Reserved 

C41t aEAR START ERR - Indicates that START PM has been 
entered for a second time. START FM Is not reentrant. 
(HARD ERROR) 

•42< Reserved 

8468 SOFTWARE ERROR - Task processor execution led to an 
Illegal software operation. 

«47« HARDWARE ERROR - The TP went logical ly Not Ready due to 
a hardware-detected error: Parity Error, Memory Limit 
Error (the TP attempted to address a nonexistent 
memory). Boundary Error (the TP tried to Increment 
addressing through the end of a memory page: 8FFFF8). 

8508 WS PAGE SIZE - The size of page Is too small to 
support the execution of the ICP. 

8518 WS END OF TABLE - the Warmstart Table loaded by the OS 
Is corrupted. 

8528 VM TID ERROR - FIND WB was unable to find the TCB of 
the task. (VM ACT CODE of VM) 

8538 VM ERROR - Descriptors exist for data and 

code segments In a TCB, PCB, or ICB; If the type passed 
Is neither of these, error Is noted. (FIND SSEG OESC 
of VM) 

8548 DISK 10 ERROR - FIND SSEG DESC was unsuccessful In 
locating the segment descriptor. (DO DISK 10 of VM) 

8558 (3ETSEGSP ERROR - FIND SSEG DESC was unsuccessful In 
attempting to relocate the seg table. (GET SEG SPACE) 

8568 SETUP DISK. ERROR - The number of segments r "^ uested to 
be brought In was greater than the maximum of 3. (SET 
UP DISK of VM). 

8578 SETUR2.DSK. ERROR - In procedure SET.UP.DISK, which Is 
building a SYSIO CCMM to bring In segs, the FIND SSEG 
DESC rountlne was unsuccessful. (SET UP DISK of VM) 

8588 CHECK VIC ERROR - VM victim segment has no associated 
descriptor; FIND SSEG DESC failed. 

8598 VM MO ROOM - VM was Invoked for other than LOCATESEGS. 
(CHECK NO ROCM). Segments can not fit In memory. 

8608 NO MEMORY - MAKE SPACE has been unsuccessful. (VM ACT 
CODE) 

8618 VICTIM SEG ASS - A segment chosen as a victim by VM has 
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an associated descriptor which shows the segment 



«62f DO CCMP ILL TYPE - During the actual compacting part of 
VM, the ne>ct block of memory has been found to have an 
Illegal type. (DO COMPACTING) 

863i SE6 COMP NO WB - In DO COMPACTING, SEG COMPACT has been 
called, which called FIND SSEG DESC, and failed to find 
the descriptor table. (SEG COMPACT) 

i64i GETSPACE TYPE ERR - A segment type Is out of range, 
meaning It Is neither VM FILE, PROG FILE, IMT TYPE, 
ZERO, or GARBAGE FILL. (GET SEG SPACE In VM) 

8658 Reserved 

8668 VM GETSEGS NOTCB - VM has cal led FIND SSEG DESC to find 
the ICB/TCB/PC8 for a segment, and It was unsuccessful. 
(VM GET SEGS In VM) 

8678 Reserved 

8678 Reserved 

8688 SRCH UPSEGS ADOR - The last pass of the virtual memory 
algorithm has searched through memory, and was not 
successful In locating space. 

8698 SRCHUPSEG NOTCB - FIND SSEG DESC has failed. (SEARCH 
UPDATED SEGS) 

8608 JC llfTERP (X!MM - TCB fl3"s are zero. (JC INTERP 
ACTION) 

8818 JC ILL OP CODE - Command handler action has detected 
that a command Is out of range. Bad parameter. 
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APPENDIX C 
SYSANALYZER ERROR MESSAGES 

An error detected in the dump file by the SYSANALYZER, or an error in the analysis, causes an error 
message to be generated within the analysis printout. These error messages are identified by one string 
of three dollar signs before the message, and another after the message: "$$$ ERROR MESSAGE 
$$$." Messages without three dollar signs are merely warnings. 

$$$ NO XX ID. TABLE ENTRY $$$ 

No ID. TABLE entry (as documented in the dump file map) was found for the memory type requested. 
The memory types ("xx") are defined as follows: 

OS -Operating System 

TP -Task Processor 

DC -Data Comm Processor 

DK -Disk Processor 
BM -Buffer Memory 

$$$ CIRCULAR LIST ERROR $$$ 

A list that circled back on itself did not circle back to the beginning. 

$$$ REVERSE LINK ERROR $$$ 

In a list that has forward and reverse links, a forward link was followed from entry <a> to entry 
<b>, but the reverse Unk in entry <b> did not point to <a>. 

$$$ QUEUE TAIL ERROR $$$ 

While analyzing a queue having a head and a tail, the tail was found not to be pointing at the last 
entry reached via the forward links. 

$$$ TABLE SIZE NOT MODULO 8 $$$ 

If this message occurs during the TCB analysis, it means that the difference between the stack base 
and the DST base in a certain TCB is not modulo 8. 

If this message occurs during the ICB/PCB analysis, it means that the difference between the Code 
Segment Table (CST) limit and the CST base in a certain PCB is not modulo 8. 

$$$ QUEUE LINK GREATER THAN QUEUE SIZE $$$ 

The queue hnk points beyond the end of the table of status blocks through which the queue is linked. 
$$$ STE LENGTH NOT EQUAL SD SIZE $$$ 

The segment table entry length is not equal to the segment descriptor size. 

$$$ SD OWNER NOT EQUAL PD/BD OWNER $$$ 

The segment descriptor owner is not equal to the physical descriptor/block descriptor owner. 
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$$$ SD WB.ID NOT EQUAL PD/BD WB.ID $$$ 

The segment descriptor work block ID is not equal to the physical descriptor/block descriptor work 
block ID. 

$$$ SD SEGMENT NUMBER INCORRECT $$$ 

The segment table entry number does not equal the segment number. 

$$$ LIST INDEX GREATER THAN LIST SIZE $$$ 

List index is greater than the list size. 

$$$ DYNAMIC ARRAY DECLARATION ERROR $$$ 

An attempt to declare data space dynamically in order to perform an analysis resulted in a value either 
zero or greater than 5000 bytes. The data declaration does not occur, and the specific subsection of 
analysis is skipped. 

$$$ LIST SHOULD NOT BE CIRCULAR $$$ 

A straight hst has been detected to circle back on itself. 

$$$ DISK READ ERROR $$$ 

An "ERROR" status has been returned to SYSANALYZER while it was trying to read from disk. 
Analysis continues at the next logical startup point, 

$$$ SEGMENT TABLE ID MISMATCH $$$ 

The value of a segment-id, as passed to the SYSANALYZER in the dump file's header record, does 
not match the value built into SYSANALYZER in order to print the names of the various segments 
in the segment table. 

$$$ ADDRESS ERROR $$$ 

When the value of the indicated address is added to the indicated length or offset, the sum exceeds 
the last address for the page of m.emory involved. (The last address for the "a<^e is determined from 
the Dump File Map.) 

$$$ TYPE INCORRECT $$$ 

The least digit of the physical descriptor type is incorrect. For TCB analysis, it should be 7; for PCB 
analysis, 8; and for ICB analysis, 9. 

$$$ P.STATUS / = WAIT.CRIT.INV $$$ 

The status field of the status block does not equal @04@. 

$$$ ID'S DO NOT MATCH $$$ 

The preceding and trailing IDs do not match. 

$$$ SIZES DO NOT MATCH $$$ 

The preceding and tralHng sizes do not match. 
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$$$ SiZE LESS THAN 7 $$$ 

The preceding size is less than 7. 

$$$ FORWARD PD ID ERROR $$$ 

The forward physical descriptor ID is not @06@. 

$$$ REVERSE PD !D ERROR $$$ 

The reverse physical descriptor ID is not @06@. 

$$$ FORWARD PD SIZE ERROR $$$ 

If 6 is added to the status block size array entry that is indexed by the action name, the resuh does 

iiv/i vvjuui Liiv 1 vyi VT U.1 \A l-'ii j oivai uvovi i^iyji lSIZ^v. 

$$$ REVERSE PD SIZE ERROR $$$ 

If 6 is added to the status block size array entry that is indexed by the action name, the result does 
not equal the reverse physical descriptor size. 
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APPENDLX D 
USER TASK ANALYSIS 

To assist in tying a user job to all of the various control and parameter blocks associated with it, use 
the following outline: 

VIRTUAL MEMORY 

1. From the mix table, locate the desired job and record the following information; 

1) Task ID. 

2) Mix Processor. 

^) Program FIR ID Heacr «ignifipa"t hvtp = Pr'R T^)^ Th<> p<^R ID ''^" v^- i.^^^ *^ i ♦„ *u- 

PCB in the task processor. 

TASK PROCESSOR <PROCESSOR NUMBER> 

1. Scan the TCB. heads for BH.ID = <task ID>. NOTE: scan all memory pages. 

2. Beneath each TCB are the FPBs associated with that task, if any. 

The least significant byte of the "SD" number of each FPB is the associated FIB segment num- 
ber (FIB ID). 

OPERATING SYSTEM 

1. Scan the WB.LB.HEAD for "owner" of DA.TASK <task ID>.LIST. 
NOTE: Convert <task id> to decimal. 

ii. otaii inc riD lisl ueiuw me wu.Lo.ncAU lor: 

1) "Owner" as determined in step 1 above. 

2) "ID" (FIB ID) as determined in step 2 for Task Processor number above. 

3) Assemble a DA.FILE-TAG from FIB entries: 

a. File tag info (I byte). 

b. File tag directory (2 bytes). 

c. File tag packtag (I byte). 

NOTE: DA.FILETAG = <file tag info >< file tag directory >< file tag packtag >. 

BUFFER MEMORY 

Scan FTE entries for DA.FILETAG as assembled in step 3) above. 
The FTEEs associated with the FTE are immediately following it. 
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NOTE 
Four FTEE descriptors will be listed, and the map of the FTE will indicate 
ine number ul uicui mm arc in-iivc. inc a3su>.iaitu lou-u^nv uunvi jwiiv>iij 
and their contents will follow each descriptor. The buffer sections are linked 
together by the "trailing link," which points to the address of the next buffer 
section. The last buffer section of an FTEE will be linked to @FFFF 
FFFF@. The FTEE itself will have a traihng Unk of Fs unless there is more 
than one FTEE associated with an FTE. 
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APPENDIX E 
A GUIDE FOR TROUBLESHOOTING SYSTEM FAILURES 

INTRODUCTION 

Some initial steps should be taken in any trouble-shooting effort. It is not always possible to do all 
of the things suggested but the more of these suggestions that are followed the easier the task of trou- 
ble-shoQting will be. 

1. Record all information which appeared on the ODT and on the lighted displays when the error 
occurred. 

2. Get a dump. 

If the system clearstarted and created a dump file in the process, this will be indicated by messages 
which appear on the ODT. If no messages have appeared and the system will still respond, take 

Cl Hiimn licinn fht' dT \^V\ r-nmrrynrtrl TIT tVio /~vr\T ir. t^^* ^^,^.^,,„:^r,t-;„ „ „ T>/->\jf J _1 1J U- 

H M..«A>x^ »uxAA^ i.xA>^ -.^j i itii^ \<«./A«4iixu&i«.«. iA i,Aiw v^i-* X ij lll.;i, v«_miIilulllv^aLlilg, a XVV>'iVl uutiip aiiuuiu uc 

taken. 

Once the dump exists it is ready to be converted into a readable format. 

If the dump is a system dump (created automatically or by GT MD), it can be converted using the 
SYSANALYZER program. 

If the dump is taken using the Hex keypad (a ROM dump), it should have ROMCONVERT run 
against it. The output of this procedure is then used as input for the SYSANALYZER program. 

There are times when ROMCONVERT can not be run. In this case, run ROMANALYZER against 
the ROM dump. 

(Directions for all these procedures are contained in the System Operations Guide.) 

3. Acquire the log file of the activities on the system when the problem occurred (use the PL com- 

manr^^ 

4. Make a copy of the SYSCONFIG file. 

5. Talk with the personnel at the site and make a note of any unusual activity when the failure oc- 
curred. 

6. If a clearstart occurred and the error message is available (the number in Bank E of the Hex 
display), the meaning of the message should be established using Appendix A to decode the num- 
ber. 

SUGGESTIONS/HINTS 

The suggestions which follow have been accumulated from successful field engineers and are included 
here in the hope that they may be of help to others. 

IF THE SYSTEM CAN'T BE RE-WARMSTARTED 

Try the redundancy switch(es), OS and/or DISK, to confirm that the problem is in the suspected 
primary processor. 

Coldstarting is a good test of the hardware. It is a good idea to: 

Replace the system files (RP). 
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If it will not damage the customer's operation too much, re-initialize the fixed disk, and then load 
the system files from the B900RL1 disk using the LD command. 

DCDCICTCMT DDHRI P^/l 
rLrtoio I i—fH I I I ix-' i-»L-.fc-i» I 

Run the appropriate MTRs. Be sure to check the MTR configuration against the configuration 
shown when CONFIGURER is run. 

A LARGE NUMBER OF CHIPS SEEM TO BE FAILING 

The problem may be a wire to that card/circuit or a track on that card. 

ENVIRONMENT IS IMPORTANT 

If the room is too hot the disk platters may expand and the disk can not be read properly. 

If the air is too dry, static may be causing problems and static mats may be needed. 

Review the log files for the date and time of failures. It may turn out that the customer is working 
after hours or on weekends when in-house air conditioning is switched off. 

CHECK CONNECTIONS 

Check the power supply. Hot or discolored fuses indicate that the connection is bad. This can cause 
low line voltages which can, in turn, affect the system memory. 

All I/O cables and I/O cable plugs sliould be checked to be sure that they are iirmly seated. 

The examples which follow are intended to be helpful for problems on different system configurations. 
It should not be assumed that all types of problems have been addressed. 

In following the outlines for the different system configurations, follow the instructions only to 
the point where a reason for the failure is found. 

SYSTEM CONFIGURATION 1 

System aborts with a SPO and a printer 

CONDITION 1: CLEARSTART - DUMP CREATED 

1. Analyze clear start message. 

2. WIN system WARMSTART7 

1 ) I f no: 

a. Analyze WARMSTART failure code. 

b. Replace system files, and rewarmstart. 

c. Run MTRs. 

2) If yes: 

a. Print and analyze log files. 

b. Print and analyze KA and LR of all disks on line at time 
of CLEAR/START. 
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c. Run MTR. 

d. Print dump file. 

e. Analyze appropriate areas for hardware errors. 

3) If reason for aEAR/START Is not found In steps a or b, 
submit FTR. 



CONDITION 2: CLEARSTART - DUMP NOT CREATED 

1. Analyze clear start message. 

2. Take ROM dump. 

3. Will system WARMSTAKT7 

1) If no: 

a. Analyze WARMSTART failure code. 

b. Relace system files, and rewarmstart. 

c. Run MTRs. 

2) If yes: 

a. Print and analyze log files. 

b. Print and analyze KA and LR of all disks on line at time of 
aEAR/START. 

c. Run ROMANALYZER and analyze IC status words. 

d. Run ROMCONVERT and SYSANALYZER. 

e. Run MTRs. 

f. Analyze appropriate areas for hardware errors. 

if reason for aEAR/START Is not found In steps a or b. submit ""R. 



CONDITION 3: SYSTEM HUNG - NO RESPONSE TO SPO MESSAGES 

1. Attempt a ROM dump. 

1 ) I f ROM does not take dump, run MTR. 

2) If RCM dump Is taken, attempt to WARMSTART. 

2. Will system WARMSTART? 

1) If no: 

a. Analyze WARMSTART failure code. 

b. Replace system files. 

c. Run MTRs. 

2) If yes: 

a. Print and analyze log files. 

b. Print and analyze KA and LR of al I disks online at time of 
CLEAR/START. 

c. Run ROMANALYZER, and analyze IC status words. 

d. Run ROMCONVERT and SYSANALYZER. 
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e> Run MTRs< 

a. Analyze appropriate areas for hardware errors. 

3) If reason for "hang" Is not found In steps a or b, submit FTR. 

CONDITION 4: TASK PROCESSOR MARKED NOT READY - DUMP 
CREATED 

Does the system have an MPL processor available? 

1 . If yes : 

1) Print and analyze log files. 

2) Print and analyze a KA and LR of al I disks online at time 
of failure. 

3) "PO" system and run MTR. 

4) Run SYSANALYZER and analyze appropriate areas. 

5) If the reason for the task processor being marked not ready 
Is not found In steps 1), 2), or 3), submit FTR. 

2. If no: 

1 ) "PO" system and WARMSTART. 

2) Will the task processor run "PL"? 

a. If yes: 

a) Print and analyze log files. 

b) Print and analyze a KA and LR of all disks online 
at time of failure. 

c) Run MTR. 

d) Run SYSANALYZER and analyze appropriate areas. 

e) If the reason for the task processor being marked 
not ready Is not found In above step, submit FTR. 

b. If no: 

a) Replace system files. 

b) Run MTRs. 



SYSTEM CONFIGURATION 2 

System aborts on a system without a printer 

CONDITION 1: CLEARSTART - DUMP CREATED 

1. Analyze CLEAR/START message. 

2. Will system WARMSTART? 

1) If no: 

a. Analyze WARMSTART failure code. 

b. Replace system files. 

c. Run MTRs. 

2) If yes: 

a. Run PL with display option and analyze any entries. 

b. Run MTR. 

c. If the reason for the aEAR/START Is not found by steps 1) 
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or 2), submit FTR. 

a) Run KA and LR to printer backup. 

b) Copy dumpflle, printer backup files, and log files to a 
removable disk, and transport to a system with a 
printer for further analysis. 

c) If the reason for the CLEAR/START Is not found by the 
above step, submit FTR. 

CONDiTiON 2: CLEARSTART - DUMP NOT CREATED 

1. Analyze CLEAR/START message. 

2. Set the OPERATE/MEM DUMP switch to MEM DUMP. 

3. Interrogate the contents of the OS processor page offsets OOOr 
through 001C memory. (Refer to CMS SOG.) 

See NOTE 2 for OS save state area. 

4. Take ROM dump. 

5. Will system WARMSTART7 

1) If no: 

a. Analyze WARMSTART failure code. 

b. Replace system files. 

c. Run MTRs. 

2) If yes: 

a. Run PL with display option and analyze any entries. 

b. Run MTR. 

c. Run KA and LR to printer backup. 

d. Copy printer backup files and log files to a different 
removable disk than used for the ROM dump, and transport to 
a system with a printer for further analysis. 

e. If the reason for the CLEAR/START Is not found In the above 
step, submit FTR. 

CONDITION 3: SYSTEM HUNG - NO RESPONSE TO SPO MESSAGES 

1. Attempt to display the contents of the OS processor page 
offsets OOOF through OOIC memory. (Refer fo CMS SOG.) 

1) If ROM does not display, run MTR. 

2) If ROM does display, analyze using layout described In step 3 
of the previous condition. 

2. Attempt a ROM dump. 

1) If dump not taken, run MTR. 
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2) If dump teken, attempt to WABMSTART 

a- If no: 

a) Analyze WAWSTART failure code. 

u# r\epiak«o oyoTSHi I I iSj" 

c) Run MTRs. 
b. If yes: 

a) Run PL with display option and analyze any entries. 

b) Run MTR. 

c) Run KA and LR to printer backup. 

d) Copy printer backup files and log files to a different 
removable disk than used for the ROM dump, and 
transport to a system with a printer for further 
analysis. 

e) If the reason for the "hang" Is not found In the pre- 
vious step, submit FTR. 



CONDITION 4: TASK PROCESSOR MARKED NOT READY - DUMP 
CREATED 



Does the system have an MPL processor available? 



1 . If yes : 

1) Run PL with "display" option and analyze any entries. 

2) Run MTR. 

3) Run KA and LR to printer backup of al I disks online at time 
of fal lure. 

4) Copy printer backup files, log files and memory dumpflle to 
removable disk, and transport to a system with printer for 
further analysis. 

5) If the reason for the failure was not found In the above 
step, FTR. 

2. If no: 

1 ) "PO" system and WAWSTART. 

2) Will the task processor run PL with the display option? 

a. If yes: 

a) Analyze any entries. 
b> Run MTR. 

c) Run KA and LR to printer backup of al I disks online 
at time of fal lure. 

d) Copy printer backup files, log files, and memory 
dumpflle to removable disk and transport to a 
system with printer for further analysis. 

e) If the reason for the failure Is not found In the 
above step, submit FTR. 

b. If no: 

a) Replace system files. 

b) Run MTRs. 
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SYSTFIWI mMPirSlipATlOM •» 

System aborts with no SPO and no printer. 

It will be very difficult to determine the time and type of failure on this system cofiguration Once 
a failure has occurred, the following steps can be followed: 

1. Attempt to dJ splay the contents of OS and disk processors save 
state areas. See NOTE 2. 

1) If RCH does not display, run MTR. 

2) If RCM displays, analyze using the layout provided In system 
configuration 2 condition 2. 

2. Attempt a RCM dump, then run the MTR. 

3. Wll I the system WARM$TART7 

1 ) I f no: 

a. Analyze the WAKMSTART error code. 

b. Replace system files. 

2) If yes: 

a. Run KA and LR to printer backup of all disks on line at 
time of failure via the remote SPO. 

b. Copy printer backup files and log files to a different 
removable disk. 

NOTE 1: If there was not sufficient disk space at WARMSTART time to 
create an empty dump file, a dump will not be taken In the 
event of a CLEAR/START, nunn rf +ka ewo+«, i.-j j.u_ -■.■•i^. 

- - , _ . _ „^ «*f ■» I «" Ma\j I no QUI I I Ty 

to do so. This case does not apply for this part of the 
outline because a RCM dump would not reflect the condition 
of the memory at the time of the failure. 

NOTE 2. Disk Processor Hard Errors: When causing freeze, these wl 1 1 
display "FOOOOO" on the hex Indlcafors: an unexpected "not 
ready", (select lock, 211 relocation table full, for 
example) can cause the system to eventually hang waiting on 
virtual memory. 

IC status Is stored at the end of disk processor memory. 
Indicated by "DP-SIZE" In a dump. It Is stored as status 1, 
error status, status 3, status 2. 

"DP-SIZE" Is located at memory address «003Ai on page of 
the disk processor. 
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NON-OS PROCESSORS 

Errors on these processors cause values to be saved at the following addresses in their own memories: 



Address 


Length 


Stored Item 


OOOB 


1 


ERROR INDICATOR 


OOOC 


1 


BO 


0000 


1 


REO 


OOOE 


2 


81 FL 


0010 


2 


B32 


0012 


1 


AD 


0013 


2 


J 


0015 


2 


K 


0017 


2 


L 


0019 


8 


XY 


0021 


2 


Ml 


0023 


2 


H2 


0025 


2 


WR 


0027 


2 


MAX 


0029 


2 


MXA 


002B 


2 


MXB 


0020 


2 


UMAR3 


002F 


2 


UMAR4 


0031 


2 


UMAR5 


0033 


2 


UMAR6 



NOTE 



ERROR INDICATOR = 00 = Hardware detected error. 
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OS PROCESSOR 

Hard errors on the OS processor cause values to be saved at the following addresses on page 0: 



Address 


Stored 


Item 


Length 


OOOF 


Ml 




2 


0011 


M2 




2 


0013 


MAX 




2 


0015 


UMR2 




2 


0017 


UMRX2 




2 


0019 


STATUS 1 




1 


001 A 


ERROR STATUS 


1 


001 B 


STATUS3 




1 


001C 


STATUS2 




1 
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APPENDIX F 
GLOSSARY OF COMMON TERMS 

This glossary only includes terms and abbreviations that are global to the system. Many terms are ex- 
plained in the appropriate place within the "SYSANALYZER output" sections of this document. 
Throughout this document, the first definition will be implied unless explicitly specified otherwise. 

NOTE 

Several terms are described as "CMS standard." These are further described 
in the CMS MCP Manual. 



^BP Available Buffer Pool. The pool of available data 

comm buffers. Managed by DCA. 

Action A discrete unit of code achieving a single 

function. 

Activity A logically related group of system functions 

comprised of a set of Interdependent actions. 

AM Activity Management. An OS activity. See Section 

8 for a concise description. 

AM.ACTION.LIST A linked list of status blocks, one block per 
active OS action. 

AVR Automatic Volume Recognition. CMS standard. 

S'^S Basic Data System . The underlying microprocessor 

see "hBDS" and "NPRO." 

BO Block Descriptor. See Task Processor, Section 10. 

BSMD Burroughs Super MInl-DIsk. 

CDC Cartridge Disk Control. 

CMS Computer Management System. CMS standard. 

CPA Communicate Parameter Area. CMS standard. 

Critical An action Is known as critical If It Is not re- 

entrant. Area of an action, known as a region, may 
be critical without the whole action being 
critical. Both actions and regions may be critical 
because they Invoke a critical action. 



CST Code Segment Table. CMS standard. 



DA 



Data Access. The OS activity handling all data 
operations. See Section 8. 



DA_CT Data Access Configuration Table. 

1118478 F-1 



DC Data Conm. Usually used with reference to data 

stor«»ge areas of the data comm activity. 

DCA Data Comm Activity. OS activity for handling all 

data conun ccraniun Icates* See Section 8» 

DCI Data Communications Interface control. That part of 

the DCP hardware that enables the connection of an 
external line to the data comm processor. 

DCP Data Communications Processor. 

DMTR Display and Malntalnance Test Routine control. 

That part of the DSiM processor hardware 
responsible for handling the hexadecimal keypad, 
the displays, and the MTR switches. 

DSiM Data Storage and Maintenance processor. 

DP Disk Processor. Same as DSiM. 

DSCP Data Storage Control Progrzmi. The firmware that 

executes In the DS&M. 

FDC Fixed Disk Control. 

FIB File information Block. For a user file this !s a 

reflection of a user FPB. 

FPB File Parameter Block. CMS standard. 

Frozen 1. A frozen processor Is an NPRO that has 
deliberately stopped Itself. 

2. A frozen segment Is an element of managed memory 
(In any processor) that cannot be swapped out or 
moved. 

HOT History Communicate Table. 

IC Interface Control. The hardware interface to the 

Processor Interconnect Bus. 

ICB Interpreter Control Block. CMS standard. 

ICMD Industry Compatible Mini-Disk. 

ICP Interpreter Control Program. The firmware that 

runs In the task processor. 

JC Job Control. The ICP activity that schedules and 

controls the execution of user Jobs within the task 
processor. 
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Jel led A Jel led segment Is an element of managed memory 
that may not be swapped out, but which may be 
moved* See frozen. 

JM Job Management. The OS activity for Job related OS 

functions. See Section 8. 

LB Linked Block. 

LSB Least Significant Bit or Byte (depending on the 

context ) . 

Mailbox The communication area of two processors. The 
content and use of mailboxes Is covered In sections 
2 and 10. 

MCP Master Control Program. Generic Burroughs term for 

an operating system. See CMS MCP Manual for 
specific CMS Implementations. 

MCS Message Control System. A user program responsible 

for controlling al I or part of a data comm network. 

Mix Number External user reference to a running Job. Mix 
nuiifcers are assigned from 1 to 99 In a round-robin 
manner. 

NOTE 

Internally the system uses a (different) task ID. 
Both are kept In the mix table. 

MN Monitor. 

Monitor The OS activity responsible for system and error 
logging and the detection of peripheral device 
errors. See Section 8. 

MSB Most Significant Bit or Byte, depending on the 

context . 

NBDS An n-channel BOS processor. See also BDS and NPRO. 

NPRO The standard processor module. An extended n- 

channel BDS microprocessor. 

ODT Operator Display Terminal. 

01 Operator Interface. The OS activity handling all 

operator messages. The activity also handles I/O 
to the ODT directly. See Section 1. 

OS Operating system. That portion of the MCP that 

runs In the OS processor, and the processor Itself. 
See Section 8. 
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PCB Program Ciontrol Block. 

PD 1. Physical Descriptor. Used In relation to task 

and buffer memories. 

2. MCP utility to report all or part of a disk 
directory. 

PHT Peripheral Handling Table. Used by DA to manage 

all peripherals attached to the system (other than 
data comm). 

PI Processor Interface. A group of related modules of 

code appearing as one activity In all processors 
(other than the OSiM) that communicate with one 
another. PI provides a processor to processor 
communication capability via the processor 
Interconnect bus. 

PIB Processor Interconnect Bus. The hard bus 

connecting the IC modules of each processor 
subsystem. 

PIC Processor Interface Control. Same as PIB and IC. 

PM Processor Management. The ICP activity responsible 

for the control of the task processor. 

PO Power Off. The MCP Intrinsic used to request the 

system to logical ly release a disk peripheral. 

Port The I/O path of the NBDS. Each hBDS has the 

capability of addressing eight ports. Port (and 
port 1 In the OS processor and DS4M) Is reserved 
for Interprocessor communication. 

Region A sub portion of an action. The term Is normally 
only used in the context of critical. 

RSO Remote SPO Operation. A system capability to allow 

the OCT function to be transferred to a remote 
device via an MCS. 

RTC Real Time Clock. Also known as TOD (Time Of Day). 

SB Status Block. See status block. 

SO. System Control Language. Standard CMS. 

SO Segment Descriptor. 

Section A portion of buffer memory. Usually a part of a 
buffer of user data. Currently a section is 180 
bytes. 
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SPO Alternative fnneinonic for ODT. 

Stackframe An Internal save area maintained for every action 
on a soft stack. 

Status Block A standard storage area reflecting the current 
status of an action. Active entries appear In the 
AM .ACT I ON .LI ST. 

STE Segment Table Entry. 

Task ID The Internal reference to a Job. This nunfcer Is a 
direct Index Into the mix table. See mix number. 

TCB Task Control Block. CMS standard. 

TOD Time Of Day. Alternative name for the real time 

clock. 

TP Task Processor. 

VM Virtual Memory. 

WB Work Block. 

*"-? Wide Line Printer. I/O control for line printers. 

Work Block A Work Block Is owned by an action, and Is used for 
a variety of data storage purposes. 
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